home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 2001 May / SGI Freeware 2001 May - Disc 1.iso / dist / fw_mysql.idb / usr / freeware / bin / mysqlaccess.z / mysqlaccess
Text File  |  1999-10-18  |  106KB  |  3,058 lines
  1. #!/bin/perl5
  2. # ****************************
  3. package MySQLaccess;
  4. #use strict;
  5.  
  6. BEGIN {
  7.     # ****************************
  8.     # static information...
  9.     $VERSION     = "2.03, 27 Feb 1997";
  10.     $0           =~ m%/([^/]+)$%o;
  11.     $script      = $1;
  12.         $script      = 'MySQLAccess' unless $script;
  13.     $script_conf = "$script.conf";
  14.     $script_log  = "/tmp/$script.log";
  15.  
  16.     # ****************************
  17.     # information on MySQL
  18.     $MYSQL     = '/usr/freeware/bin/mysql';    # path to mysql executable
  19.     $SERVER    = '3.21';
  20.     $MYSQL_OPT = ' --batch --unbuffered';
  21.     $ACCESS_DB = 'mysql';         # name of DB with grant-tables
  22.     $ACCESS_H  = 'host';         # 
  23.     $ACCESS_U  = 'user';             # 
  24.     $ACCESS_D  = 'db';               #
  25.     # Add/Edit privileges
  26.     $ACCESS_H_TMP = 'host_tmp';      
  27.     $ACCESS_U_TMP = 'user_tmp';      
  28.     $ACCESS_D_TMP = 'db_tmp';        
  29.     $ACCESS_H_BCK = 'host_backup';   
  30.     $ACCESS_U_BCK = 'user_backup';   
  31.     $ACCESS_D_BCK = 'db_backup';     
  32.         $DIFF      = '/usr/bin/diff'; 
  33.         $TMP_PATH  = '/tmp';             #path to writable tmp-directory
  34.         $MYSQLDUMP = '/usr/local/bin/mysqldump';
  35.         $MYSQLDUMP = '/usr/freeware/bin/mysqldump';
  36.                                          #path to mysqldump executable
  37.  
  38.         $MYSQLADMIN= 'http://foobar.com/MySQLadmin';
  39.                                          #URL of CGI for manipulating
  40.                                          #the temporary grant-tables
  41. }
  42.  
  43. $INFO = <<"_INFO";
  44. --------------------------------------------------------------------------
  45.    mysqlaccess (Version $VERSION)
  46.    ~~~~~~~~~~~
  47.    Copyright (C) 1997,1998 Yves.Carlier\@rug.ac.be
  48.                            University of Ghent (RUG), Belgium
  49.                            Administratieve Informatieverwerking (AIV)
  50.  
  51.    report the access-privileges for a USER from a HOST to a DB
  52.  
  53.    Many thanks go to <monty\@mysql.com> and <psmith\@BayNetworks.COM>
  54.    for their suggestions, debugging and patches. 
  55.  
  56.    use `$script -?' to get more information on available options.
  57.  
  58.    From version 2.0x, $script can also be used through a WEB-browser
  59.    if it is ran as a CGI-script.  (See the release-notes)
  60.  
  61. --------------------------------------------------------------------------
  62. _INFO
  63.  
  64. $OPTIONS = <<_OPTIONS;
  65.  
  66. Usage: $script [host [user [db]]] OPTIONS
  67.  
  68.   -?, --help           display this helpscreen and exit
  69.   -v, --version        print information on the program `$script'
  70.  
  71.   -u, --user=#         username for logging in to the db
  72.   -p, --password=#     validate password for user
  73.   -h, --host=#         name or IP-number of the host
  74.   -d, --db=#           name of the database
  75.  
  76.   -U, --superuser=#    connect as superuser
  77.   -P, --spassword=#    password for superuser
  78.   -H, --rhost=#        remote MySQL-server to connect to
  79.       --old_server     connect to old MySQL-server (before v3.21) which 
  80.                        does not yet know how to handle full where clauses.
  81.  
  82.   -b, --brief          single-line tabular report
  83.   -t, --table          report in table-format
  84.  
  85.   --relnotes           print release-notes
  86.   --plan               print suggestions/ideas for future releases
  87.   --howto              some examples of how to run `$script'
  88.   --debug=N            enter debuglevel N (0..3)
  89.  
  90.   --copy               reload temporary grant-tables from original ones
  91.   --preview            show differences in privileges after making
  92.                        changes in (temporary) grant-tables
  93.   --commit             copy grant-rules from temporary tables to grant-tables
  94.                        (!don't forget to do an mysqladmin reload)
  95.   --rollback           undo the last changes to the grant-tables.
  96.  
  97.   Note:
  98.     + At least the user and the db must be given (even with wildcards)
  99.     + If no host is given, `localhost' is assumed
  100.     + Wilcards (*,?,%,_) are allowed for host, user and db, but be sure 
  101.       to escape them from your shell!! (ie type \\* or '*')
  102. _OPTIONS
  103.  
  104. $RELEASE = <<'_RELEASE';
  105.  
  106. Release Notes:
  107. -------------
  108.   0.1-beta1: internal
  109.   - first trial.
  110.  
  111.   0.1-beta2: (1997-02-27)
  112.   - complete rewrite of the granting-rules, based on the documentation
  113.     found in de FAQ.
  114.   - IP-number and name for a host are equiv.
  115.  
  116.   0.1-beta3: (1997-03-10)
  117.   - more information
  118.   - 'localhost' and the name/ip of the local machine are now equiv.
  119.  
  120.   0.1-beta4: (1997-03-11)
  121.   - inform the user if he has not enough priv. to read the mysql db
  122.  
  123.   1.0-beta1: (1997-03-12)
  124.   suggestions by Monty:
  125.   - connect as superuser with superpassword.
  126.   - mysqlaccess could also notice if all tables are empty. This means
  127.     that all user have full access!
  128.   - It would be nice if one could optionally start mysqlaccess without
  129.     any options just the arguments 'user db' or 'host user db', where
  130.     host is 'localhost' if one uses only two arguments.
  131.  
  132.   1.0-beta2: (1997-03-14)
  133.   - bugfix: translation to reg.expr of \_ and \%.
  134.   - bugfix: error in matching regular expression and string given
  135.             by user which resulted in
  136.             'test_123' being matched with 'test'
  137.  
  138.   1.0-beta3: (1997-03-14)
  139.   - bugfix: the user-field should not be treated as a sql-regexpr,
  140.             but as a plain string.
  141.   - bugfix: the host-table should not be used if the host isn't empty in db
  142.                                           or  if the host isn't emty in user
  143.             (Monty)
  144.  
  145.   1.0-beta4: (1997-03-14)
  146.   - bugfix: in an expression "$i = $j or $k", the '=' binds tighter than the or
  147.             which results in problems...
  148.             (by Monty)
  149.   - running mysqlaccess with "perl -w" gives less warnings...   ;-)
  150.  
  151.   1.0-beta5: (1997-04-04)
  152.   - bugfix: The table sorting was only being applied to the "user" table; all
  153.             the tables need to be sorted.  Rewrote the sort algorithm, and
  154.             the table walk algorithm (no temp file anymore), and various
  155.             other cleanups.  I believe the access calculation is 100% correct.
  156.             (by Paul D. Smith <psmith\@baynetworks.com>)
  157.   - Allow the debug level to be set on the cmd line with --debug=N.
  158.             (by Paul D. Smith <psmith\@baynetworks.com>)
  159.   - More -w cleanups; should be totally -w-clean.
  160.             (by Paul D. Smith <psmith\@baynetworks.com>)
  161.  
  162.   1.1-beta1: (1997-04-xx) 
  163.   1.1-beta2: (1997-04-11)
  164.   - new options:
  165.              --all_users : report access-rights for all possible users
  166.              --all_dbs   : report access-rights for all possible dbs
  167.              --all_hosts : report access-rights for all possible hosts
  168.              --brief     : as brief as possible, don't mention notes,warnings and rules
  169.              --password  : validate password for user 
  170.   - layout: long messages are wrapped on the report.
  171.   - functionality:
  172.             more descriptive notes and warnings
  173.             wildcards (*,?) are allowed in the user,host and db options
  174.             setting xxxx=* is equiv to using option --all_xxxx
  175.             note: make sure you escape your wildcards, so they don't get
  176.                   interpreted by the shell.  use \* or '*'
  177.   - bugfix: Fieldnames which should be skipped on the output can now have
  178.             a first capital letter.
  179.   - bugfix: any option with a '.' (eg ip-number) was interpreted as
  180.             a wildcard-expression.
  181.   - bugfix: When no entry was found in the db-table, the default accessrights are
  182.             N, instead of the faulty Y in a previous version.
  183.  
  184.   1.1-beta-3  : (1997-04-xx)
  185.   1.1-beta-4  : (1997-04-xx)
  186.   1.1-beta-5  : (1997-04-xx)
  187.   1.1         : (1997-04-28)
  188.   - new options:
  189.             --rhost     : name of mysql-server to connect to
  190.             --plan      : print suggestions/ideas for future releases
  191.             --relnotes  : display release-notes
  192.             --howto     : display examples on how to use mysqlaccess
  193.             --brief     : single-line tabular output
  194.   - functionality/bugfix:
  195.     *      removed options --all_users,--all_dbs,--all_hosts, which 
  196.            were redundant with the wildcard-expressions for the corresponding
  197.            options. They made the processing of the commandline too painful 
  198.            and confusing ;-)
  199.            (suggested by psmith)
  200.     *      redefined the option --brief, which now gives a single-line 
  201.            tabular output
  202.     *      Now we check if the right version of the mysql-client is used,
  203.            since we might use an option not yet implemented in an
  204.            older version (--unbuffered, since 3.0.18)
  205.            Also the error-messages the mysql-client reports are 
  206.            better interpreted ;-)  
  207.     *      Wildcards can now be given following the SQL-expression 
  208.            (%,_) and the Regular-expression (*,?) syntax.
  209.   - speed: we now open a bidirectional pipe to the mysql-client, and keep 
  210.            it open throughout the whole run. Queries are written to,
  211.            and the answers read from the pipe.
  212.            (suggested by monty)
  213.   - bugfixes:
  214.     *      the Rules were not properly reset over iterations 
  215.     *      when in different tables the field-names were not identical, 
  216.            eg. Select_priv and select_priv, they were considered as 
  217.            definitions of 2 different access-rights.
  218.     *      the IP-number of a host with a name containing wildcards should
  219.            not be searched for in Name2IP and IP2Name.
  220.     *      various other small things, pointed out by <monty> and <psmith>
  221.  
  222.   1.2         : (1997-05-13)
  223.   - bugfix:
  224.     * Fixed bug in acl with anonymous user:  Now if one gets accepted by the
  225.       user table as a empty user name, the user name is set to '' when 
  226.       checking against the 'db' and 'host' tables. (Bug fixed in MySQL3.20.19)
  227.  
  228.   1.2-1       : (1997-xx-xx)
  229.   - bugfix:
  230.     * hashes should  be initialized with () instead of {} <psmith>
  231.     * "my" variable $name masks earlier declaration in same scope,
  232.       using perl 5.004 <????>
  233.  
  234.   1.2-2       : (1997-06-10)
  235.     
  236.   2.0p1-3     : (1997-10-xx)
  237.   - new
  238.     * packages
  239.     * log-file for debug-output : /tmp/mysqlaccess.log
  240.     * default values are read from a configuration file $script.conf
  241.       first this file is looked for in the current directory; if not
  242.       found it is looked for in /etc/
  243.       Note that when default-values are given, these can't get overriden
  244.       by empty (blanc) values!
  245.     * CGI-BIN version with HTML and forms interface.  Simply place the
  246.       script in an ScriptAliased directory, make the configuration file
  247.       available in the that directory or in /etc, and point your browser
  248.       to the right URL. 
  249.     * copy the grant-rules to temporary tables, where you are safe to
  250.       play with them.
  251.     * preview changes in privileges after changing grant-rules,
  252.       before taking them into production
  253.     * copy the new grant-rules from the temporary tables back to the
  254.       grant-tables.
  255.     * Undo all changes made in the grant-tables (1-level undo).
  256.   -new options:
  257.     * --table   : as opposite of the --brief option.
  258.     * --copy    : (re)load temporary grant-tables from original ones.
  259.     * --preview : preview changes in privileges after changing
  260.                   some or more entries in the grant-tables.
  261.     * --commit  : copy grant-rules from temporary tables to grant-tables
  262.                   (!don't forget to do an mysqladmin reload)
  263.     * --rollback: undo the last changes to the grant-tables.
  264.  
  265.   - bugfix:
  266.     * if the table db is empty, mysqlaccess freezed 
  267.       (by X Zhu <X.Zhu@Bradford.ac.uk>)
  268.  
  269.   2.0         : (1997-10-09)
  270.   - fixed some "-w" warnings.
  271.   - complain when certain programs and paths can't be found.
  272.  
  273.   2.01        : (1997-12-12)
  274.   - bugfix:
  275.     * rules for db-table where not calculated and reported correctly.
  276.   2.02        : (1998-01-xx)
  277.   - bugfix:
  278.     * Privileges of the user-table were not AND-ed properly with the
  279.       other privileges. (reported by monty)
  280.   - new option:
  281.     * --old_server: mysqlaccess will now use a full where clause when
  282.                     retrieving information from the MySQL-server.  If
  283.                     you are connecting to an old server (before v3.21)
  284.                     use the option --old_server.
  285.   2.03         : (1998-02-27)
  286.   - bugfix:
  287.     * in Host::MatchTemplate: incorrect match if host-field was left empty.
  288.  
  289. _RELEASE
  290.  
  291. $TODO = <<_TODO;
  292.  
  293.  Plans:
  294.  -----
  295.   -a full where clause is use now.  How can we handle older servers?
  296.   -add some more functionality for DNS.
  297.   -select the warnings more carefuly.
  298.   >>  I think that the warnings should either be enhanced to _really_
  299.   >>  understand and report real problems accurately, or restricted to
  300.   >>  only printing things that it knows with 100% certainty. <psmith)
  301.   >>  Why do I have both '%' and 'any_other_host' in there?  Isn't that
  302.   >>  the same thing?  I think it's because I have an actual host '%' in
  303.   >>  one of my tables.  Probably the script should catch that and not
  304.   >>  duplicate output. <psmith>
  305.  
  306. _TODO
  307.  
  308. # From the FAQ: the Grant-algorithm
  309. # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  310. # The host table is mainly to maintain a list of "secure" servers.
  311. # At TCX hosts contain a list of all machines on local network. These are granted
  312. # all privileges.
  313. # Technically the user grant is calculated by:
  314. #
  315. #    1.First sort all entries by host by putting host without wildcards first,
  316. #      after this host with wildcards and entries with host = ".
  317. #      Under each host sort user by the same criterias.
  318. #    2.Get grant for user from the "db" table.
  319. #    3.If hostname is "empty" for the found entry, AND the privileges with
  320. #      the privileges for the host in "host" table.
  321. #      (Remove all which is not "Y" in both)
  322. #    4.OR (add) the privileges for the user from the "user" table.
  323. #     (add all privileges which is "Y" in "user")
  324. #
  325. #    When matching, use the first found match.
  326. #
  327. # -----------------------------------------------------------------------------------
  328.  
  329. $HOWTO = <<_HOWTO;
  330.  
  331. Examples of how to call $script:
  332. ~~~~~~~~
  333. 1)Calling $script with 2 arguments:
  334.  
  335.   \$ $script root mysql
  336.      ->report rights of user root logged on at the local host in db mysql
  337.  
  338.   Access-rights
  339.   for USER 'root', from HOST 'localhost', to DB 'mysql'
  340.           +-----------------+---+ +-----------------+---+
  341.           | select_priv     | Y | | drop_priv       | Y |
  342.           | insert_priv     | Y | | reload_priv     | Y |
  343.           | update_priv     | Y | | shutdown_priv   | Y |
  344.           | delete_priv     | Y | | process_priv    | Y |
  345.           | create_priv     | Y | | file_priv       | Y |
  346.           +-----------------+---+ +-----------------+---+
  347.   BEWARE:  Everybody can access your DB as user 'root'
  348.         :  WITHOUT supplying a password.  Be very careful about it!!
  349.  
  350.   The following rules are used:
  351.    db    : 'No matching rule'
  352.    host  : 'Not processed: host-field is not empty in db-table.'
  353.    user  : 'localhost','root','','Y','Y','Y','Y','Y','Y','Y','Y','Y','Y'
  354.  
  355. 2)Calling $script with 3 arguments:
  356.  
  357.   \$ $script foo.bar nobody Foo 
  358.      ->report rights of user root logged in at machine foobar to db Foo
  359.  
  360.   Access-rights
  361.   for USER 'nobody', from HOST 'foo.bar', to DB 'Foo'
  362.           +-----------------+---+ +-----------------+---+
  363.           | select_priv     | Y | | drop_priv       | N |
  364.           | insert_priv     | Y | | reload_priv     | N |
  365.           | update_priv     | Y | | shutdown_priv   | N |
  366.           | delete_priv     | Y | | process_priv    | N |
  367.           | create_priv     | N | | file_priv       | N |
  368.           +-----------------+---+ +-----------------+---+
  369.   BEWARE:  Everybody can access your DB as user 'nobody'
  370.         :  WITHOUT supplying a password.  Be very careful about it!!
  371.  
  372.   The following rules are used:
  373.    db    : 'foo.bar','Foo','nobody','Y','Y','Y','N','N','N'
  374.    host  : 'Not processed: host-field is not empty in db-table.'
  375.    user  : 'foo.bar','nobody','','N','N','N','Y','N','N','N','N','N','N'
  376.  
  377. 3)Using wildcards:
  378.  
  379.   \$ $script  \\* nobody Foo --brief
  380.      ->report access-rights of user nobody from all machines to db Foo,
  381.        and use a matrix-report.
  382.  
  383.   Sel  Ins  Upd  Del  Crea Drop Reld Shut Proc File Host,User,DB        
  384.   ---- ---- ---- ---- ---- ---- ---- ---- ---- ---- --------------------
  385.    Y    Y    Y    Y    N    N    N    N    N    N   localhost,nobody,Foo
  386.    N    N    N    N    N    N    N    N    N    N   %,nobody,Foo  
  387.    N    N    N    N    N    N    N    N    N    N   any_other_host,nobody,Foo
  388.  
  389. _HOWTO
  390.  
  391.  
  392. # +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ #
  393. #                       START OF THE PROGRAM                            #
  394. # +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ #
  395.  
  396. use Getopt::Long;
  397. use Sys::Hostname;
  398. use IPC::Open2;
  399. #use CGI;            #moved to use of CGI by monty
  400.  
  401.  
  402. # ****************************
  403. # debugging flag
  404. # can be set to 0,1,2,3
  405. # a higher value gives more info
  406. # ! this can also be set on the command-line
  407.     $DEBUG   = 0;
  408.  
  409. # ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++>8
  410. #  Normaly nothing should be changed beneeth this line
  411.  
  412.  
  413. # ****************************
  414. # no caching on STDOUT
  415.     $|=1;
  416.  
  417.  
  418.  
  419. $NEW_USER = 'ANY_NEW_USER';
  420. $NEW_DB   = 'ANY_NEW_DB'  ;
  421.  
  422.  
  423. # %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% #
  424. #  mysqlaccess:                                              #
  425. #  ~~~~~~~~~~~                                               #
  426. #  Lets get to it,                                           #
  427. #  and start the program by processing the parameters        #
  428. # %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% #
  429.  
  430. ($CMD,$CGI) = GetMode();
  431.  
  432. # ****************************
  433. # the copyright message should
  434. # always be printed (once)
  435. MySQLaccess::Report::Print_Header();
  436.  
  437. # *****************************
  438. # Read configuration-file
  439.   MySQLaccess::Debug::Print(1, "Reading configuration file...");
  440.   if (-f "./$script_conf") {
  441.      require "./$script_conf";
  442.   }
  443.   elsif (-f "/etc/$script_conf") {
  444.      require "/etc/$script_conf";
  445.   }
  446.  
  447. # ****************************
  448. # Read in all parameters
  449. if ($MySQLaccess::CMD) { #command-line version
  450.     # ----------------------------
  451.     # Get options from commandline
  452.     $Getopt::Long::ignorecase=0; #case sensitive options
  453.     if ( grep(/\-\?/,@ARGV) ) { MySQLaccess::Report::Print_Usage(); exit 0; }
  454.     GetOptions("help"          => \$Param{'help'}
  455.               ,"host|h=s"      => \$Param{'host'}
  456.               ,"user|u=s"      => \$Param{'user'}
  457.               ,"password|p=s"  => \$Param{'password'}
  458.               ,"db|d=s"        => \$Param{'db'}
  459.               ,"superuser|U=s" => \$Param{'superuser'}
  460.               ,"spassword|P=s" => \$Param{'spassword'}
  461.               ,"rhost|H=s"     => \$Param{'rhost'}
  462.                   ,"old_server"    => \$Param{'old_server'}
  463.               ,"debug=i"       => \$Param{'DEBUG'}
  464.               ,"brief|b"       => \$Param{'brief'}
  465.               ,"table|t"       => \$Param{'table'}
  466.               ,"relnotes"      => \$Param{'relnotes'}
  467.               ,"plan"          => \$Param{'plan'}
  468.               ,"howto"         => \$Param{'howto'}
  469.               ,"version|v"     => \$Param{'version'}
  470.                   ,"preview"       => \$Param{'preview'}
  471.                   ,"copy"          => \$Param{'copy'}
  472.                   ,"commit"        => \$Param{'commit'}
  473.                   ,'rollback'      => \$Param{'rollback'}
  474.           );
  475.  
  476.         # -----------------------------
  477.         # set DEBUG
  478.         $DEBUG = $Param{'DEBUG'} if ($Param{'DEBUG'}>=$DEBUG);
  479.  
  480.     # -----------------------------
  481.     # check for things which aren't
  482.     # declared as options:
  483.     # 2 arguments: (user,db) -> ('localhost','user','db')
  484.     if ($#ARGV == 1) {
  485.        MySQLaccess::Debug::Print(2,"$script called with 2 arguments:");
  486.        $Param{'host'} = $Param{'host'} || 'localhost'; 
  487.        $Param{'user'} = $ARGV[0] || $Param{'user'};
  488.            $Param{'db'}   = $ARGV[1] || $Param{'db'}; 
  489.     }
  490.     # 3 arguments: (host,user,db)
  491.     if ($#ARGV == 2) {
  492.        MySQLaccess::Debug::Print(2,"$script called with 3 arguments:");
  493.        $Param{'host'} = $ARGV[0] || $Param{'host'};
  494.        $Param{'user'} = $ARGV[1] || $Param{'user'};
  495.        $Param{'db'}   = $ARGV[2] || $Param{'db'};
  496.     }
  497. }
  498. if ($MySQLaccess::CGI) { #CGI-version
  499.     use CGI;
  500.      $Q = new CGI;
  501.     $Param{'help'} = $Q->param('help') ;
  502.     $Param{'host'} = $Q->param('host') || $Q->param('h') || $Param{'host'};
  503.     $Param{'user'} = $Q->param('user') || $Q->param('u') || $Param{'user'};
  504.     $Param{'db'}   = $Q->param('db')   || $Q->param('d') || $Param{'db'};
  505.     $Param{'password'}  = $Q->param('password')  || $Q->param('p') || $Param{'password'};
  506.     $Param{'superuser'} = $Q->param('superuser') || $Q->param('U') || $Param{'superuser'};
  507.     $Param{'spassword'} = $Q->param('spassword') || $Q->param('P') || $Param{'spassword'};
  508.     $Param{'rhost'}     = $Q->param('rhost')     || $Q->param('H') || $Param{'rhost'};
  509.     $Param{'old_server'}= $Q->param('old_server')|| $Param{'old_server'};
  510.     $Param{'debug'}     = $Q->param('debug')     || $Param{'debug'};
  511.     $Param{'brief'}     = $Q->param('brief')     || $Param{'brief'}; 
  512.     $Param{'table'}     = $Q->param('table')     || $Param{'table'}; 
  513.     $Param{'relnotes'}  = $Q->param('relnotes');
  514.     $Param{'plan'}      = $Q->param('plan');
  515.     $Param{'howto'}     = $Q->param('howto'); 
  516.     $Param{'version'}   = $Q->param('version') ? $Q->param('version') : $Q->param('v');
  517.     $Param{'edit'}      = $Q->param('edit'); 
  518.     $Param{'preview'}   = $Q->param('preview'); 
  519.     $Param{'copy'}      = $Q->param('copy'); 
  520.     $Param{'commit'}    = $Q->param('commit'); 
  521.     $Param{'rollback'}  = $Q->param('rollback'); 
  522.         # -----------------------------
  523.         # set DEBUG
  524.         $DEBUG = $Q->param('debug') if ($Q->param('debug')>=$DEBUG);
  525. }
  526.  
  527. # ----------------------
  528. # brief and table-format 
  529. # exclude each-other
  530. # table-format is prefered
  531. if (defined($Param{'table'})) { undef($Param{'brief'}); }
  532. if (defined($Param{'preview'}) or
  533.     defined($Param{'copy'}) or
  534.     defined($Param{'commit'}) or
  535.     defined($Param{'rollback'}) ) { $Param{'edit'}='on'; }
  536.  
  537.  
  538. # ----------------------
  539. # if no host is given
  540. # assume we mean 'localhost'
  541. if (!defined($Param{'host'}))      { $Param{'host'}='localhost'; }
  542.  
  543. # ----------------------
  544. # perform some checks
  545. # -> eliminate 'broken pipe' error
  546. push(@MySQLaccess::Grant::Error,'not_found_mysql')     if !(-x $MYSQL);
  547. push(@MySQLaccess::Grant::Error,'not_found_diff')      if !(-x $DIFF);
  548. push(@MySQLaccess::Grant::Error,'not_found_mysqldump') if !(-x $MYSQLDUMP);
  549. push(@MySQLaccess::Grant::Error,'not_found_tmp')       if !(-d $TMP_PATH);
  550. push(@MySQLaccess::Grant::Error,'write_err_tmp')       if !(-w $TMP_PATH);
  551. if (@MySQLaccess::Grant::Error) {
  552.    MySQLaccess::Report::Print_Error_Messages() ;
  553.    exit 0;
  554. }
  555.  
  556. #-----------------------
  557. # get info/help if necc.
  558. $print_usage=1;
  559. if ( defined($Param{'version'}) ) {
  560.    MySQLaccess::Report::Print_Version();
  561.    $print_usage=0;
  562.    MySQLaccess::Report::Print_Footer();
  563.    MySQLaccess::DB::CloseConnection();
  564.    exit 0;
  565. #   exit 0;
  566. }
  567. if ( defined($Param{'relnotes'}) ) {
  568.    MySQLaccess::Report::Print_Relnotes();
  569.    $print_usage=0;
  570.    MySQLaccess::Report::Print_Footer();
  571.    MySQLaccess::DB::CloseConnection();
  572.    exit 0;
  573. #   exit 0;
  574. }
  575. if ( defined($Param{'plan'}) ) {
  576.    MySQLaccess::Report::Print_Plans();
  577.    $print_usage=0;
  578.    MySQLaccess::Report::Print_Footer();
  579.    MySQLaccess::DB::CloseConnection();
  580.    exit 0;
  581. #   exit 0;
  582. }
  583. if ( defined($Param{'howto'}) ) {
  584.    MySQLaccess::Report::Print_HowTo();
  585.    $print_usage=0;
  586.    MySQLaccess::Report::Print_Footer();
  587.    MySQLaccess::DB::CloseConnection();
  588.    exit 0;
  589. #   exit 0;
  590. }
  591.  
  592. # -----------------------------
  593. # generate a help-screen in CMD-mode
  594. # or a blanc form in CGI-mode 
  595. if ( defined($Param{'help'}) 
  596.      or !defined($Param{'user'}) 
  597.      or !defined($Param{'host'})
  598.      or !defined($Param{'db'}) 
  599.    ) {
  600.    push(@MySQLaccess::Grant::Error,'user_required') unless defined($Param{'user'});
  601.    push(@MySQLaccess::Grant::Error,'db_required') unless defined($Param{'db'});
  602.    push(@MySQLaccess::Grant::Error,'host_required') unless defined($Param{'host'});
  603.    MySQLaccess::Report::Print_Usage() if $print_usage;
  604.    exit 0;
  605. }
  606.  
  607.  
  608. # ----------------------------
  609. # get hostname and local-ip
  610. # for localhost
  611. $localhost = MySQLaccess::Host::LocalHost();
  612. $local_ip  = MySQLaccess::Host::Name2IP($localhost);
  613. $MySQLaccess::Host::localhost = MySQLaccess::Host::LocalHost();
  614. $MySQLaccess::Host::local_ip  = MySQLaccess::Host::Name2IP($localhost);
  615. MySQLaccess::Debug::Print(3, "localhost name=$localhost, ip=$local_ip");
  616.  
  617. #-----------------------------------
  618. # version of MySQL-server to connect
  619. # to determine use of full where clause
  620. $MySQLaccess::Host::SERVER = $Param{'old_server'} ? '3.20' : $SERVER;
  621.  
  622. #---------------------------------
  623. # Inform user if he has not enough
  624. # privileges to read the access-db
  625. if ( $nerror=MySQLaccess::DB::OpenConnection() ) {
  626.     MySQLaccess::Report::Print_Error_Access($nerror);
  627.     exit 0;
  628. }
  629.  
  630. # -----------------------
  631. # Read MySQL ACL-files
  632. if ($nerror=MySQLaccess::Grant::ReadTables()) {
  633.     MySQLaccess::Report::Print_Error_Access($nerror);
  634.     exit 0;
  635. };
  636. if ($Param{'edit'} and $nerror=MySQLaccess::Grant::ReadTables('tmp')) {
  637.     MySQLaccess::Report::Print_Error_Access($nerror);
  638.     exit 0;
  639. }
  640.  
  641. #---------------------------------
  642. # reload temporay grant-tables 
  643. # with data from original ones
  644. if ( defined($Param{'copy'}) ) {
  645.    $nerror=MySQLaccess::DB::LoadTmpTables();
  646.    if ($nerror) {
  647.       MySQLaccess::Report::Print_Error_Access($nerror);
  648.       exit 0;
  649.    }
  650.    my $msg = "The grant-rules are copied from the grant-tables to\n"
  651.            . "the temporary tables.";
  652.    MySQLaccess::Report::Print_Message([$msg]);
  653. #   MySQLaccess::Report::Print_Footer();
  654. #   MySQLaccess::DB::CloseConnection();
  655. #   exit 0;
  656. }
  657.  
  658.  
  659. #---------------------------------
  660. # preview result of changes in the 
  661. # grant-tables
  662. if ( defined($Param{'preview'}) ) {
  663.    $aref=MySQLaccess::Grant::Diff_Privileges();
  664.    MySQLaccess::Report::Print_Diff_ACL($aref);
  665. #   MySQLaccess::Report::Print_Footer();
  666. #   MySQLaccess::DB::CloseConnection();
  667. #   exit 0;
  668. }
  669.  
  670.  
  671. #---------------------------------
  672. # reload grant-tables 
  673. # with data from temporary tables
  674. if ( defined($Param{'commit'}) ) {
  675.    if ($nerror = MySQLaccess::DB::CommitGrantTables()) {
  676.       MySQLaccess::Report::Print_Error_Access($nerror);
  677.       exit 0;
  678.    }
  679.    my $msg = "The grant-rules have been copied from the temporary tables\n"
  680.            . "to the grant-tables.";
  681.    my $msg1= "Don't forget to do an 'mysqladmin reload' before these\n"
  682.            . "changes take effect.";
  683.    my $msg2= "A backup-version of your original grant-rules are saved in the\n"
  684.            . "backup-tables, so you can always perform a 1-level rollback.";
  685.    MySQLaccess::Report::Print_Message([$msg,$msg1,$msg2]);
  686. #   MySQLaccess::Report::Print_Footer();
  687. #   MySQLaccess::DB::CloseConnection();
  688. #   exit 0;
  689. }
  690.  
  691. #---------------------------------
  692. # restore previous grant-rules
  693. # with data from backup tables
  694. if ( defined($Param{'rollback'}) ) {
  695.    if ($nerror = MySQLaccess::DB::RollbackGrantTables()) {
  696.       MySQLaccess::Report::Print_Error_Access($nerror);
  697.       exit 0;
  698.    }
  699.    my $msg = "The old grant-rules have been copied back from the backup tables\n"
  700.            . "to the grant-tables.";
  701.    my $msg1= "Don't forget to do an 'mysqladmin reload' before these\n"
  702.            . "changes take effect.";
  703.    MySQLaccess::Report::Print_Message([$msg,$msg1]);
  704. #   MySQLaccess::Report::Print_Footer();
  705. #   MySQLaccess::DB::CloseConnection();
  706. #   exit 0;
  707. }
  708. #----------------------------------
  709. # show edit-taskbar
  710. if ( defined($Param{'edit'})) {
  711.    if ($MySQLaccess::CGI ) {
  712.    MySQLaccess::Report::Print_Edit();
  713.    $print_usage=0;
  714.    MySQLaccess::Report::Print_Footer();
  715.    MySQLaccess::DB::CloseConnection();
  716.    exit 0;
  717.    }
  718.    else {
  719.    MySQLaccess::Report::Print_Edit();
  720.    $print_usage=0;
  721.    MySQLaccess::Report::Print_Footer();
  722.    MySQLaccess::DB::CloseConnection();
  723.    exit 0;
  724.    }
  725. }
  726.  
  727.  
  728. # -----------------------------
  729. # Build list of users,dbs,hosts
  730. # to process...
  731. @all_dbs   = @{MySQLaccess::DB::Get_All_dbs($Param{'db'})};
  732. @all_users = @{MySQLaccess::DB::Get_All_users($Param{'user'})};
  733. @all_hosts = @{MySQLaccess::DB::Get_All_hosts($Param{'host'})};
  734. #if EDIT-mode
  735. #@all_dbs_tmp   = @{MySQLaccess::DB::Get_All_dbs($Param{'db'},'tmp')};
  736. #@all_users_tmp = @{MySQLaccess::DB::Get_All_users($Param{'user'},'tmp')};
  737. #@all_hosts_tmp = @{MySQLaccess::DB::Get_All_hosts($Param{'host'},'tmp')};
  738.  
  739. # -----------------------------
  740. # Report access-rights for each
  741. # tuple (host,user,db)
  742. #$headers=0;
  743. my %Access = ();
  744. foreach $host (@all_hosts) {
  745.   foreach $user (@all_users) {
  746.     foreach $db (@all_dbs) {
  747.       MySQLaccess::Grant::Initialize();
  748.       %Access = MySQLaccess::Grant::Get_Access_Rights($host,$user,$db);    
  749.       MySQLaccess::Report::Print_Access_rights($host,$user,$db,\%Access);
  750.     }
  751.   }
  752. }
  753.  
  754. # -----------------------------
  755. # End script
  756. MySQLaccess::Report::Print_Footer();
  757. MySQLaccess::DB::CloseConnection();
  758. exit 0;
  759.  
  760. #############################################################
  761. #  FUNCTIONS  #
  762. ###############
  763. sub GetMode {
  764.    my $cmd=0;
  765.    my $cgi=0;
  766.    if (defined($ENV{'HTTP_HOST'})) { $cmd=0; $cgi=1; }
  767.    else                            { $cmd=1; $cgi=0; } 
  768.    return ($cmd,$cgi);
  769. }
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776. ######################################################################
  777. package MySQLaccess::DB;
  778. ###########
  779. BEGIN {
  780.     $DEBUG     = 2;
  781.     $DEBUG     = $MySQLaccess::DEBUG unless ($DEBUG);
  782.     # Error-messages from the MySQL client
  783.     %ACCESS_ERR= ('Access_denied'       => 'Access denied' 
  784.                  ,'Dbaccess_denied'     => 'Access to database denied'
  785.                  ,'Unrecognized_option' => 'unrecognized option' 
  786.                  ,'Unknown_table'       => "Can't find file:"
  787.                  ,'unknown_error'       => '^ERROR:'
  788.                  );
  789. }
  790. # ######################################
  791. #  Connecting to the MYSQL DB
  792. # ======================================
  793. # sub OpenConnection
  794. #  Open an connection to the mysql-db
  795. #  questions to MYSQL_Q
  796. #  answers from MYSQL_A
  797. # ======================================
  798. sub OpenConnection {
  799.     my $pid;
  800.     MySQLaccess::Debug::Print(2,"OpenConnection:");
  801.  
  802.     # check path to mysql-client executable
  803.     if (! -f $MySQLaccess::MYSQL) {
  804.        if ($MySQLaccess::CMD) { die "Could not find MySQL-client '$MySQLaccess::MYSQL'"; }
  805.        if ($MySQLaccess::CGI) { 
  806.           print "<center>\n<font color=Red>\n";
  807.           print "ERROR: Could not find MySQL-client '$MySQLaccess::MYSQL'";
  808.           print "</center>\n</font>\n";
  809.           exit 0;
  810.        }
  811.     }
  812.  
  813.     # path to mysql executable
  814.     my $connect = "$MySQLaccess::MYSQL $MySQLaccess::MYSQL_OPT";
  815.     # user,password and host
  816.     if (defined($MySQLaccess::Param{'superuser'})) { $connect .= " --user=$MySQLaccess::Param{'superuser'}"; }
  817.     if (defined($MySQLaccess::Param{'spassword'})) { $connect .= " --password=$MySQLaccess::Param{'spassword'}"; }
  818.     if (defined($MySQLaccess::Param{'rhost'}))     { $connect .= " --host=$MySQLaccess::Param{'rhost'}"; }
  819.     # other options??
  820.  
  821.     # grant-database
  822.     $connect .= " $MySQLaccess::ACCESS_DB";
  823.  
  824.     $connect .= " 2>&1";
  825.     # open connection
  826.     MySQLaccess::Debug::Print(2,"Connecting to: $connect");
  827.     $pid=IPC::Open2::open2(\*MYSQL_A,\*MYSQL_Q,$connect);
  828.     MySQLaccess::Debug::Print(2,"PID of open pipe: $pid");
  829.     
  830.     # check connection 
  831.     print MYSQL_Q "select 'ok';\n";
  832.     $answer = <MYSQL_A>; #answer from mysql
  833.     MySQLaccess::Debug::Print(2,"Answer: $answer\n");
  834.     foreach $nerror (sort(keys(%ACCESS_ERR))) {
  835.       MySQLaccess::Debug::Print(3,"check answer for error $ACCESS_ERR{$nerror}");
  836.       if (grep(/$ACCESS_ERR{$nerror}/i,$answer)) { 
  837.          MySQLaccess::Debug::Print(2,"Answer contain error [$nerror]");
  838.          return $nerror; 
  839.       }
  840.     }
  841.  
  842. if (0) {
  843.     # check server-version 
  844.     print MYSQL_Q "select 'ok';\n";
  845.     $answer = <MYSQL_A>; #answer from mysql
  846.     MySQLaccess::Debug::Print(2,"Answer: $answer\n");
  847.     foreach $nerror (sort(keys(%ACCESS_ERR))) {
  848.       MySQLaccess::Debug::Print(3,"check answer for error $ACCESS_ERR{$nerror}");
  849.       if (grep(/$ACCESS_ERR{$nerror}/i,$answer)) { 
  850.          MySQLaccess::Debug::Print(2,"Answer contain error [$nerror]");
  851.          return $nerror; 
  852.       }
  853.     }
  854. }
  855.  
  856.     my $skip=<MYSQL_A>; 
  857.     return 0; 
  858. }
  859.  
  860. # ======================================
  861. # sub CloseConnection
  862. #  Close the connection to the mysql-db
  863. # ======================================
  864. sub CloseConnection {
  865.     close MYSQL_Q;
  866.     close MYSQL_A;
  867. }
  868.  
  869. # ===========================================================
  870. # sub CreateTable($table)
  871. #  Create temporary/backup table
  872. # ===========================================================
  873. sub CreateTable {
  874.     my ($table,$force) = @_;
  875.     my %tables = ( $MySQLaccess::ACCESS_U_TMP => $MySQLaccess::ACCESS_U,
  876.                    $MySQLaccess::ACCESS_H_TMP => $MySQLaccess::ACCESS_H,
  877.                    $MySQLaccess::ACCESS_D_TMP => $MySQLaccess::ACCESS_D,
  878.                    $MySQLaccess::ACCESS_U_BCK => $MySQLaccess::ACCESS_U,
  879.                    $MySQLaccess::ACCESS_H_BCK => $MySQLaccess::ACCESS_H,
  880.                    $MySQLaccess::ACCESS_D_BCK => $MySQLaccess::ACCESS_D,
  881.                    $MySQLaccess::ACCESS_U => $MySQLaccess::ACCESS_U_BCK,
  882.                    $MySQLaccess::ACCESS_H => $MySQLaccess::ACCESS_H_BCK,
  883.                    $MySQLaccess::ACCESS_D => $MySQLaccess::ACCESS_D_BCK,
  884.                  ); 
  885.     my $tbl;
  886.     my $query="";
  887.     my $delim;
  888.     my $skip;
  889.     my $create;
  890.     my @known_tables=();
  891.  
  892. #    print STDERR "CreateTable($table)\n";
  893.     MySQLaccess::Debug::Print(1,"CreateTable($table):");
  894.  
  895.     ## error-handling
  896.     return 'Unknown_table' unless defined($tables{$table});
  897.  
  898.     ## build list of known/existing tables;
  899.     ## if 'force' existing table is dropped first
  900.     if (defined($force) and $force) {
  901.        @known_tables = Show_Tables();
  902.        if (grep(/^$table$/,@known_tables)) {
  903.        $query = "DROP TABLE $table;";
  904.        }
  905.     }
  906.  
  907.     ## path to mysqldump executable
  908.     my $connect = "$MySQLaccess::MYSQLDUMP --no-data";
  909.     # user,password and host
  910.     if (defined($MySQLaccess::Param{'superuser'})) { $connect .= " --user=$MySQLaccess::Param{'superuser'}"; }
  911.     if (defined($MySQLaccess::Param{'spassword'})) { $connect .= " --password=$MySQLaccess::Param{'spassword'}"; }
  912.     if (defined($MySQLaccess::Param{'rhost'}))     { $connect .= " --host=$MySQLaccess::Param{'rhost'}"; }
  913.     $connect .= " $MySQLaccess::ACCESS_DB";
  914.     $connect .= " $tables{$table}";
  915.     $connect .= " 2>&1 |";
  916.  
  917.  
  918.     ## get creation-data for original table
  919.     $create = '';
  920.     my $mysqldump = $connect;
  921.     $mysqldump =~ s/ \$TABLE / $tbl /;
  922.     open(CREATE,"$mysqldump");
  923.     @create = <CREATE>;
  924.     $create = "@create";
  925.     foreach $nerror (sort(keys(%ACCESS_ERR))) {
  926.        MySQLaccess::Debug::Print(3,"check answer for error $ACCESS_ERR{$nerror}");
  927.        if (grep(/$ACCESS_ERR{$nerror}/i,$create)) { 
  928.           MySQLaccess::Debug::Print(2,"Answer contain error [$nerror]");
  929.           return $nerror; 
  930.        }
  931.     }
  932.     close(CREATE);
  933.  
  934.     ## manipulate result for creation-data for temporary table
  935.     $create =~ s/CREATE TABLE $tables{$table} \(/CREATE TABLE $table \(/;
  936.  
  937.     ## recreate temporary table
  938.     $query .= "$create\n";
  939.     $query .= "select 'ok';";
  940.  
  941.     ## execute query
  942.     print MYSQL_Q "$query\n";
  943. #    print STDERR $query;
  944.  
  945.     $answer = <MYSQL_A>; #answer from mysql
  946. #    print STDERR "A>",$answer;
  947.     MySQLaccess::Debug::Print(2,"Answer: $answer\n");
  948.     foreach $nerror (sort(keys(%ACCESS_ERR))) {
  949. #       print STDERR "->$nerror?";
  950.        MySQLaccess::Debug::Print(3,"check answer for error $ACCESS_ERR{$nerror}");
  951.        if (grep(/$ACCESS_ERR{$nerror}/i,$answer)) { 
  952. #          print STDERR "Yes!";
  953.           MySQLaccess::Debug::Print(2,"Answer contain error [$nerror]");
  954.           return $nerror; 
  955.        }
  956.     }
  957.  
  958.     $delim = <MYSQL_A>; # read header
  959.     if ($delim ne "ok\n") {
  960.        while (($line=<MYSQL_A>) ne "ok\n")
  961.        { MySQLaccess::Debug::Print(3," A> $line"); }
  962.         $skip = <MYSQL_A>; # skip result 'ok'
  963.     }
  964. #    print STDERR "CreateTable done\n";
  965.     return 0;
  966. }
  967.  
  968.  
  969. # ===========================================================
  970. # sub CopyTable()
  971. #  Copy the structure and the data of a table to another table
  972. # ===========================================================
  973. sub CopyTable {
  974.     my ($from,$to,$force) = @_;
  975.     my @known_tables  = Show_Tables();    
  976.     my $query = "";
  977.     my $nerror= 0;
  978.     my $skip;
  979.  
  980. #    print STDERR "CopyTable($from,$to)\n";
  981.     MySQLaccess::Debug::Print(1,"MySQLaccess::DB::CopyTable($from,$to)");
  982.  
  983.     ## error-handling
  984.     if (!grep(/^$from$/,@known_tables)) { return 'Unknown_table'; }
  985.  
  986.     ## copy structure 
  987.     ## if forced
  988.     if (defined($force) and $force) {
  989.        return $nerror if ($nerror=CreateTable($to,$force)); 
  990. #       print STDERR "Structure copied\n";
  991.     }
  992.  
  993.     ## copy data
  994.     $query .= "DELETE FROM $to;";
  995.     $query .= "INSERT INTO $to SELECT * FROM $from;";
  996.     $query .= "SELECT 'ok';\n";
  997.     MySQLaccess::Debug::Print(2,"Query: $query");
  998.        
  999.     ## execute query
  1000.     print MYSQL_Q "$query\n";
  1001. #    print STDERR $query;
  1002.  
  1003.     ## check for errors...
  1004.     my $answer = <MYSQL_A>; #answer from mysql
  1005. #    print STDERR $answer;
  1006.     MySQLaccess::Debug::Print(2,"Answer: $answer\n");
  1007.     foreach $nerror (sort(keys(%ACCESS_ERR))) {
  1008.        MySQLaccess::Debug::Print(3,"check answer for error $ACCESS_ERR{$nerror}");
  1009.        if (grep(/$ACCESS_ERR{$nerror}/i,$answer)) { 
  1010.           MySQLaccess::Debug::Print(2,"Answer contain error [$nerror]");
  1011.           return $nerror; 
  1012.        }
  1013.     }
  1014.  
  1015.     my $delim = <MYSQL_A>; # read header
  1016. #    print STDERR $delim;
  1017.     if ($delim ne "ok\n") {
  1018.        while (($line=<MYSQL_A>) ne "ok\n")
  1019.        { MySQLaccess::Debug::Print(3," A> $line"); }
  1020.        $skip = <MYSQL_A>; # skip result 'ok'
  1021.     }
  1022.  
  1023.     return 0;
  1024. }
  1025.  
  1026. # ===========================================================
  1027. # sub LoadTmpTables()
  1028. #  (Re)load temporary tables with entries of ACL-tables
  1029. # ===========================================================
  1030. sub LoadTmpTables {
  1031.     my %tables = ( $MySQLaccess::ACCESS_U => $MySQLaccess::ACCESS_U_TMP,
  1032.                    $MySQLaccess::ACCESS_H => $MySQLaccess::ACCESS_H_TMP,
  1033.                    $MySQLaccess::ACCESS_D => $MySQLaccess::ACCESS_D_TMP,
  1034.                  ); 
  1035.     my $tbl;
  1036.     my $nerror;
  1037.     
  1038. #    print STDERR "LoadTmpTables:\n";
  1039.     MySQLaccess::Debug::Print(1,"LoadTmpTables():");
  1040.     foreach $tbl (keys(%tables)) {
  1041. #       print STDERR "$tbl -> $tables{$tbl}\n";
  1042.        MySQLaccess::Debug::Print(2,"Loading table $tbl -> $tables{$tbl}.");
  1043.        return $nerror if ($nerror=CopyTable($tbl,$tables{$tbl},'force'));
  1044.     }
  1045.     return 0;
  1046. }
  1047.  
  1048. # ===========================================================
  1049. # sub BackupGrantTables()
  1050. #  Make a backup of the original grant-tables
  1051. # ===========================================================
  1052. sub BackupGrantTables {
  1053.     my %tables = ( $MySQLaccess::ACCESS_U => $MySQLaccess::ACCESS_U_BCK,
  1054.                    $MySQLaccess::ACCESS_H => $MySQLaccess::ACCESS_H_BCK,
  1055.                    $MySQLaccess::ACCESS_D => $MySQLaccess::ACCESS_D_BCK,
  1056.                  ); 
  1057.     my $tbl;
  1058.     my $nerror;
  1059.     
  1060. #    print STDERR "BackupGrantTables:\n";
  1061.     MySQLaccess::Debug::Print(1,"BackupGrantTables():");
  1062.     foreach $tbl (keys(%tables)) {
  1063. #       print STDERR "$tbl -> $tables{$tbl}\n";
  1064.        MySQLaccess::Debug::Print(2,"Backup table $tbl -> $tables{$tbl}.");
  1065.        return $nerror if ($nerror=CopyTable($tbl,$tables{$tbl},'force'));
  1066.     }
  1067.     return 0;
  1068. }
  1069.  
  1070. # ===========================================================
  1071. # sub RollbackGrantTables()
  1072. #  Rollback the backup of the grant-tables
  1073. # ===========================================================
  1074. sub RollbackGrantTables {
  1075.     my %tables = ( $MySQLaccess::ACCESS_U_BCK => $MySQLaccess::ACCESS_U,
  1076.                    $MySQLaccess::ACCESS_H_BCK => $MySQLaccess::ACCESS_H,
  1077.                    $MySQLaccess::ACCESS_D_BCK => $MySQLaccess::ACCESS_D,
  1078.                  ); 
  1079.     my $tbl;
  1080.     my $nerror;
  1081.     
  1082. #    print STDERR "RollbackGrantTables:\n";
  1083.     MySQLaccess::Debug::Print(1,"RollbackGrantTables():");
  1084.     foreach $tbl (keys(%tables)) {
  1085. #       print STDERR "$tbl -> $tables{$tbl}\n";
  1086.        MySQLaccess::Debug::Print(2,"Rollback table $tbl -> $tables{$tbl}.");
  1087.        return $nerror if ($nerror=CopyTable($tbl,$tables{$tbl},'force'));
  1088.     }
  1089.     return 0;
  1090. }
  1091.  
  1092.  
  1093. # ===========================================================
  1094. # sub CommitGrantTables()
  1095. #  Copy grant-rules from temporary tables to the ACL-tables
  1096. # ===========================================================
  1097. sub CommitGrantTables {
  1098.     my %tables = ( $MySQLaccess::ACCESS_U => $MySQLaccess::ACCESS_U_TMP,
  1099.                    $MySQLaccess::ACCESS_H => $MySQLaccess::ACCESS_H_TMP,
  1100.                    $MySQLaccess::ACCESS_D => $MySQLaccess::ACCESS_D_TMP,
  1101.                  ); 
  1102.     my $tbl;
  1103.     my $query;
  1104.     my $delim;
  1105.     my $skip;
  1106.     my $create;
  1107.  
  1108.     print STDERR "CommitGrantTables()\n";
  1109.     MySQLaccess::Debug::Print(1,"CommitGrantTables():");
  1110.     
  1111.     ## Make backup of original grant-tables
  1112.     MySQLaccess::Debug::Print(2,"Making backup of original grant-tables...");
  1113.     BackupGrantTables();
  1114.  
  1115.     ## Copy data from temporay tables to grant-tables
  1116.     foreach $tbl (keys(%tables)) {
  1117.        print STDERR "$tbl -> $tables{$tbl}\n";
  1118.        MySQLaccess::Debug::Print(2,"Loading data $tables{$tbl} -> $tbl.");
  1119.        return $nerror if ($nerror=CopyTable($tables{$tbl},$tbl));
  1120.     }
  1121.     return 0;
  1122. }
  1123.  
  1124.  
  1125. # ===========================================================
  1126. # sub Show_Fields($table): 
  1127. #  return (a reference to) a hash which holds the names
  1128. #  of all relevant grant-fields, with their index in the record,
  1129. #  and (a reference to) an array which holds the fieldnames.
  1130. # ===========================================================
  1131. sub Show_Fields {
  1132.     my ($table) = @_;
  1133.     my %skip = ('host' => [0,1]
  1134.                ,'user' => [0,1,2]
  1135.                ,'db'   => [0,1,2]
  1136.                );
  1137.     my %Struct = ();
  1138.     my @Struct = ();
  1139.     my $query = "show fields from $table;select 'ok';\n";
  1140.     my $i=0;
  1141.     my $line;
  1142.  
  1143. #print STDERR $query;
  1144.     MySQLaccess::Debug::Print(1,"Show_Fields($table):");
  1145.     MySQLaccess::Debug::Print(2,"SQL: $query");
  1146.  
  1147.     print MYSQL_Q "$query";
  1148.     my $skip = <MYSQL_A>;  #skip header
  1149.     while (($line=<MYSQL_A>) ne "ok\n")
  1150.     {
  1151. #print STDERR ">",$line;
  1152.     chop($line);
  1153.     MySQLaccess::Debug::Print(2," $table>: $line");
  1154.     my ($field,$type,$null,$key,$default,$extra) = split(' ',$line);
  1155.         $field = ucfirst($field); 
  1156.     MySQLaccess::Debug::Print(3, " <split: $field - $type - $null - $key - $default - $extra");
  1157.     if (! grep(/$i/,@{$skip{$table}}) ){
  1158.        $Struct{$field} = $i; #hash
  1159.        push(@Struct,$field); #array
  1160.        MySQLaccess::Debug::Print(3," ==> added column[$i]: $field ($Struct{$field})");
  1161.     } 
  1162.         else {
  1163.            MySQLaccess::Debug::Print(3," ==> skipped column[$i], value=[$field]");
  1164.         }
  1165.     $i++;
  1166.     }
  1167.  
  1168.     $skip=<MYSQL_A>;  # Get ok row (found already ok header)
  1169.  
  1170.     MySQLaccess::Debug::Print(2, "Array:");
  1171.     foreach $field (@Struct) { MySQLaccess::Debug::Print(2,"+ $field"); }
  1172.     MySQLaccess::Debug::Print(2,"Hash:");
  1173.     foreach $field (keys(%Struct)) { MySQLaccess::Debug::Print(2,"+ $field -> $Struct{$field}"); }
  1174.  
  1175.     return  (\%Struct,\@Struct); 
  1176. }
  1177.  
  1178. # ===========================================================
  1179. # sub Show_Tables(): 
  1180. #  return (a reference to) an array which holds all 
  1181. #  known tables.
  1182. # ===========================================================
  1183. sub Show_Tables {
  1184.     my @Tables = ();
  1185.     my $query = "show tables;select 'ok';\n";
  1186.     my $i=0;
  1187.     my $line;
  1188.  
  1189.     MySQLaccess::Debug::Print(1,"Show_Tables():");
  1190.     MySQLaccess::Debug::Print(2,"SQL: $query");
  1191.  
  1192.     print MYSQL_Q "$query";
  1193.     my $skip = <MYSQL_A>;  #skip header
  1194.     while (($line=<MYSQL_A>) ne "ok\n")
  1195.     {
  1196.     chop($line);
  1197.     push(@Tables,$line); #array
  1198.     MySQLaccess::Debug::Print(3," ==> added table: $line");
  1199.     }
  1200.  
  1201.     $skip=<MYSQL_A>;  # Get ok row (found already ok header)
  1202.  
  1203.     MySQLaccess::Debug::Print(2, "Array:");
  1204.     foreach $tbl (@Tables) { MySQLaccess::Debug::Print(2,"+ $tbl"); }
  1205.  
  1206.     return @Tables; 
  1207. }
  1208.  
  1209. # ======================================
  1210. # sub Validate_Password($passwd,$host,$user,$encpw)
  1211. #  Validate the given password 
  1212. #  for user '$user' 
  1213. #  connecting from host '$host'
  1214. # ======================================
  1215. sub Validate_Password {
  1216.     my ($password,$host,$user,$encpw) = @_;
  1217.     my $valid=0;
  1218.  
  1219.     MySQLaccess::Debug::Print(1,"Validate_Password($password,$host,$user,$encpw)");
  1220.     my $sql = "select host,user,password from user having "
  1221.              ."host='$host' and user='$user' and password='$encpw' "
  1222.              ."and password=PASSWORD('$password');\n";
  1223.     $sql .= "select 'ok';\n";
  1224.     MySQLaccess::Debug::Print(2,"SQL = $sql");
  1225.     print MYSQL_Q "$sql";
  1226.     
  1227.     # if password is valid, at least 1 row returns before we read 'ok'
  1228.     while ( ($line=<MYSQL_A>) ne "ok\n") {
  1229.       MySQLaccess::Debug::Print(2," A> $line");
  1230.       $valid = defined($line); 
  1231.     }
  1232.     my $skip = <MYSQL_A>; # read 'ok'
  1233.  
  1234.     return $valid;
  1235. }
  1236.  
  1237.  
  1238. # ==========================================================
  1239. # sub Sort_fields: (rewritten by psmith)
  1240. #  Build the query for an ordered list of entries
  1241. # ==========================================================
  1242. sub Sort_fields {
  1243.   my ($start, $end, $sofar, $this, @rest) = (@_);
  1244.   my @where = ("((FIELD not like '\\%') AND (FIELD <> ''))",
  1245.                "((FIELD like '%\\%%') OR (FIELD like '%\\_%'))",
  1246.                "(FIELD = '')");
  1247.   my $res = '';
  1248.  
  1249.   $this or return ("$start $sofar $end");
  1250.  
  1251.   $sofar .= ' AND ' if $sofar;
  1252.  
  1253.   foreach $w (@where) {
  1254.     my $f = $w;
  1255.     $f =~ s/FIELD/$this/g;
  1256.  
  1257.     $res .= Sort_fields($start, $end, "$sofar$f", @rest);
  1258.   }
  1259.  
  1260.   return ($res);
  1261. }
  1262.  
  1263. # ===========================================================
  1264. # sub Sort_table: (rewritten by psmith)
  1265. #  return all entries in the given table,
  1266. #  in an ordered fashion
  1267. # ===========================================================
  1268. sub Sort_table {
  1269.     my ($tbl, @order) = @_;
  1270.     my @res=();
  1271.  
  1272.     # as long as there's no full where clause (Distrib 3.20)...
  1273.     # use having :-(
  1274.     # NOTE: this clause WILL NOT work on 3.21, because of the
  1275.     # order of 'ORDER BY' and 'HAVING'
  1276.     my $start = "SELECT *,UCASE(host) as ucase_host FROM $tbl ";
  1277.     $start   .= 'ORDER BY ' . join(',', @order) ." HAVING ";
  1278.     my $end   = ";\n";
  1279.  
  1280.     # server version 3.21 has a full where clause :-)
  1281.     if ($MySQLaccess::Host::SERVER >= '3.21') {
  1282. print "+++USING FULL WHERE CLAUSE+++\n";
  1283.        $start = "SELECT *,UCASE(host) as ucase_host FROM $tbl WHERE ";
  1284.        $end = ' ORDER BY ' . join(',', @order) . ";\n";
  1285.     }
  1286.  
  1287.     MySQLaccess::Debug::Print(1,"Sort_table():");
  1288.     MySQLaccess::Debug::Print(2,"Sorting table $tbl by `@order'");
  1289.  
  1290.     my $tmp;
  1291.     foreach $tmp (@order)
  1292.     {
  1293.       $tmp="UCASE(host)" if ($tmp eq "ucase_host");
  1294.     }
  1295.     my $query  = Sort_fields($start, $end, '', @order);
  1296.     $query    .= "select 'ok';\n";
  1297.     MySQLaccess::Debug::Print(2,"Query: $query");
  1298.  
  1299.     print MYSQL_Q "$query\n";
  1300.  
  1301.     my $delim = <MYSQL_A>; # read header
  1302.     MySQLaccess::Debug::Print(3," A> $delim");
  1303.     if ($delim ne "ok\n") {
  1304.        if ($delim =~ /^ERROR/) {
  1305.        push(@MySQLaccess::Grant::Error,'use_old_server');
  1306.        MySQLaccess::Report::Print_Error_Messages() ;
  1307.        exit 1;
  1308.        }
  1309.        while (($line=<MYSQL_A>) ne "ok\n")
  1310.        {
  1311.            MySQLaccess::Debug::Print(3," A> $line");
  1312.            push(@res,$line);
  1313.        }
  1314.     }
  1315.     my $skip = <MYSQL_A>; # skip result 'ok'
  1316.  
  1317.     # remove columnheaders from output
  1318.     @res = grep(!/^\Q$delim\E$/, @res);
  1319.     # remove trailing \n from each returned record
  1320.     chomp(@res); 
  1321.     # each record has 1 field to much : ucase_host
  1322.     @res = grep { /(.*)\t.*$/; $_ = $1; } @res;
  1323.  
  1324.     MySQLaccess::Debug::Print(2,"Result of sorted table $tbl:");
  1325.     foreach $line (@res) { MySQLaccess::Debug::Print(2," >>$line"); }
  1326.     return @res;
  1327. }
  1328.  
  1329. # ===========================================================
  1330. # sub Get_All_db(template): 
  1331. #  return all db the grant-tables are working on,
  1332. #  which conform to the template
  1333. # ===========================================================
  1334. sub Get_All_dbs {
  1335.    my ($template,$tmp) = @_;
  1336.    my @db=();
  1337.    my $aref;
  1338.  
  1339.    # working with  temporary tables or production tables
  1340.    if (defined($tmp) and $tmp) {
  1341.       $aref = \@MySQLaccess::Grant::sorted_db_tmp_table ;
  1342.    }
  1343.    else {
  1344.       $aref = \@MySQLaccess::Grant::sorted_db_table;
  1345.    }
  1346.  
  1347.    MySQLaccess::Debug::Print(1," template=[$template]");
  1348.  
  1349.    # get all db for which access-rights can be calculated,
  1350.    # which conform to the template.
  1351.    # !! these db's don't have to exist yet, so it's not
  1352.    #    enough to look which db already exist on the system
  1353.    $reg_expr = $template;
  1354.    if ($template =~ /[\*\?]/) {
  1355.       $reg_expr =~ tr/*?/%_/;
  1356.       #$reg_expr = MySQLaccess::Wildcards::Wild2Reg($template);
  1357.    }
  1358.    $reg_expr = MySQLaccess::Wildcards::SQL2Reg("$reg_expr");
  1359.  
  1360.    if ( ! ($template =~ /[\*\?%_]/) ) {
  1361.       push(@db,$template);
  1362.       return \@db;
  1363.    }
  1364.  
  1365.    MySQLaccess::Debug::Print(2,"#Reading db-table...");
  1366.    foreach $record (@{$aref}) { #MySQLaccess::Grant::sorted_db_table) {
  1367.     my @record=split(/\t/,$record);
  1368.     my $db = $record[1];
  1369.     MySQLaccess::Debug::Print(2,"> $db ");
  1370.     if ( (!grep(/$db/i,@db)) and ($db =~/$reg_expr/i) ) {
  1371.        push(@db,$db);
  1372.        MySQLaccess::Debug::Print(2,"added");
  1373.     } 
  1374.     else {
  1375.        MySQLaccess::Debug::Print(2,"skipped");
  1376.     }
  1377.    }
  1378.    # if no rule is found for a certain db in the db-table,
  1379.    # the rights of the user are used, so we should inform
  1380.    # the user for
  1381.    if (!grep(/^%$/,@db)) { push(@db,"$MySQLaccess::NEW_DB"); }
  1382.    return \@db;
  1383. }
  1384.  
  1385. # ===========================================================
  1386. # sub Get_All_users(template): 
  1387. #  return all users the grant-tables are working on,
  1388. #  which conform to the template
  1389. # ===========================================================
  1390. sub Get_All_users {
  1391.    ($template,$tmp) = @_; # nog verder uitwerken!!!
  1392.    my @user=();
  1393.    my $aref;
  1394.  
  1395.    # working with  temporary tables or production tables
  1396.    if (defined($tmp) and $tmp) {
  1397.       $aref = \@MySQLaccess::Grant::sorted_user_tmp_table ;
  1398.    }
  1399.    else {
  1400.       $aref = \@MySQLaccess::Grant::sorted_user_table;
  1401.    }
  1402.  
  1403.    MySQLaccess::Debug::Print(1,"Debug Get_All_users:");
  1404.    # get all db for which access-rights can be calculated.
  1405.    # !! these db's don't have to exist yet, so it's not
  1406.    #    enough to look which db already exist on the system
  1407.    $reg_expr = $template;
  1408.    if ($template =~ /[\*\?]/) {
  1409.       $reg_expr =~ tr/*?/%_/;
  1410.       #$reg_expr = MySQLaccess::Wildcards::Wild2Reg($template);
  1411.    }
  1412.    $reg_expr = MySQLaccess::Wildcards::SQL2Reg("$reg_expr");
  1413.  
  1414.    if ( ! ($template =~ /[\*\?%_]/) ) {
  1415.       push(@user,$template);
  1416.       return \@user;
  1417.    }
  1418.  
  1419.    MySQLaccess::Debug::Print(2,"#Reading user-table...");
  1420.    foreach $record (@{$aref}) { #MySQLaccess::Grant::sorted_user_table) {
  1421.     my @record=split(/\t/,$record);
  1422.     my $user = $record[1];
  1423.     MySQLaccess::Debug::Print(2,"> $user ");
  1424.     if ( (!grep(/$user/,@user)) and ($user=~/$reg_expr/)) {
  1425.        push(@user,$user);
  1426.        MySQLaccess::Debug::Print(2, "added");
  1427.     } 
  1428.     else {
  1429.        MySQLaccess::Debug::Print(2, "skipped");
  1430.     }
  1431.    }
  1432.    # Any user means also:
  1433.    # - the 'empty' user, ie without supplying a username
  1434.    # - any user still to be defined/created
  1435.    #push(@user,'');               #without_suplying_a_username
  1436.    push(@user,"$MySQLaccess::NEW_USER");
  1437.    #push(@Warnings,'minimum_priv');
  1438.    return \@user;
  1439. }
  1440.  
  1441. # ===========================================================
  1442. # sub Get_All_hosts(template): 
  1443. #  return all hosts the grant-tables are working on,
  1444. #  which conform to the template
  1445. # ===========================================================
  1446. sub Get_All_hosts {
  1447.    my ($template,$tmp) = @_;
  1448.    my @host=();
  1449.    my $aref;
  1450.    my $aref1;
  1451.  
  1452.    # working with  temporary tables or production tables
  1453.    if (defined($tmp) and $tmp) {
  1454.       $aref = \@MySQLaccess::Grant::sorted_host_tmp_table ;
  1455.       $aref1= \@MySQLaccess::Grant::sorted_db_tmp_table ;
  1456.    }
  1457.    else {
  1458.       $aref = \@MySQLaccess::Grant::sorted_host_table;
  1459.       $aref1= \@MySQLaccess::Grant::sorted_db_table ;
  1460.    }
  1461.  
  1462.    MySQLaccess::Debug::Print(1, "Debug Get_All_hosts:");
  1463.    # get all db for which access-rights can be calculated.
  1464.    # !! these db's don't have to exist yet, so it's not
  1465.    #    enough to look which db already exist on the system
  1466.    $reg_expr = $template;
  1467.    if ($template =~ /[\*\?]/) {
  1468.       $reg_expr =~ tr/*?/%_/;
  1469.       #$reg_expr = MySQLaccess::Wildcards::Wild2Reg($template);
  1470.    }
  1471.    $reg_expr = MySQLaccess::Wildcards::SQL2Reg("$reg_expr");
  1472.  
  1473.    if ( ! ($template =~ /[\*\?%_]/) ) {
  1474.       push(@host,$template);
  1475.       return \@host;
  1476.    }
  1477.  
  1478.    MySQLaccess::Debug::Print(1, "#Reading db-table...");
  1479.    foreach $record (@{$aref1}) { #MySQLaccess::Grant::sorted_db_table) {
  1480.     my @record=split(/\t/,$record);
  1481.     my $host = $record[0];
  1482.     MySQLaccess::Debug::Print(2, "> $host ");
  1483.     if (! grep(/$host/i,@host)) {
  1484.        push(@host,$host);
  1485.        MySQLaccess::Debug::Print(2, "added");
  1486.     } 
  1487.     else {
  1488.        MySQLaccess::Debug::Print(2, "skipped");
  1489.     }
  1490.    }
  1491.    MySQLaccess::Debug::Print(1, "#Reading host-table...");
  1492.    foreach $record (@{$aref}) {
  1493.     my @record=split(/\t/,$record);
  1494.     my $host = $record[0];
  1495.     MySQLaccess::Debug::Print(2, "> $host ");
  1496.     if ( (!grep(/$host/,@host)) and ($host=~/$reg_expr/)) {
  1497.        push(@host,$host);
  1498.        MySQLaccess::Debug::Print(2, "added");
  1499.     } 
  1500.     else {
  1501.        MySQLaccess::Debug::Print(2, "skipped");
  1502.     }
  1503.    }
  1504.    # DOUBT:
  1505.    #print "#Reading user-table...\n" if ($DEBUG>1);
  1506.    #foreach $record (@MySQLaccess::Grant::sorted_user_table) {
  1507.    # my @record=split(/\t/,$record);
  1508.    # my $host = $record[0];
  1509.    # print "> $host " if ($DEBUG>2);
  1510.    # if ( (!grep(/$host/,@host)) and ($host=~/$reg_expr/)) {
  1511.    #    push(@host,$host);
  1512.    #    print "added\n" if ($DEBUG>2);
  1513.    # } 
  1514.    # else {
  1515.    #    print "skipped\n" if ($DEBUG>2);
  1516.    # }
  1517.    #}
  1518.    # Any host also means:
  1519.    # - any host still to be defined/created
  1520.    #push(@host,"any_other_host");
  1521.  
  1522.    @host = sort(@host);
  1523.    return \@host;
  1524. }
  1525.  
  1526.  
  1527. ##########################################################################
  1528. package MySQLaccess::Grant;
  1529. ##############
  1530. BEGIN {
  1531.     $DEBUG     = 0;
  1532.     $DEBUG     = $MySQLaccess::DEBUG unless ($DEBUG);
  1533. }
  1534.  
  1535.  
  1536.  
  1537. # ===========================================================
  1538. # sub Diff_Privileges()
  1539. #  Calculate diff between temporary and original grant-tables
  1540. # ===========================================================
  1541. sub Diff_Privileges {
  1542.    my @before=();
  1543.    my @after =();
  1544.    my @diffs =();
  1545.  
  1546.    # -----------------------------
  1547.    # Build list of users,dbs,hosts
  1548.    # to process...
  1549.    my @all_dbs   = @{MySQLaccess::DB::Get_All_dbs('*')};
  1550.    my @all_users = @{MySQLaccess::DB::Get_All_users('*')};
  1551.    my @all_hosts = @{MySQLaccess::DB::Get_All_hosts('*')};
  1552.    #if EDIT-mode
  1553.    my @all_dbs_tmp   = @{MySQLaccess::DB::Get_All_dbs('*','tmp')};
  1554.    my @all_users_tmp = @{MySQLaccess::DB::Get_All_users('*','tmp')};
  1555.    my @all_hosts_tmp = @{MySQLaccess::DB::Get_All_hosts('*','tmp')};
  1556.  
  1557.  
  1558.    my %Access;
  1559.    # ------------------------------------
  1560.    # Build list of priv. for grant-tables
  1561.    foreach $host (@all_hosts) {
  1562.      foreach $user (@all_users) {
  1563.        foreach $db (@all_dbs) {
  1564.          MySQLaccess::Grant::Initialize();
  1565.          %Access = MySQLaccess::Grant::Get_Access_Rights($host,$user,$db);    
  1566.          push(@before,MySQLaccess::Report::Raw_Report($host,$user,$db,\%Access));
  1567.        }
  1568.      }
  1569.    }
  1570.  
  1571.    # ----------------------------------
  1572.    # Build list of priv. for tmp-tables
  1573.    foreach $host (@all_hosts_tmp) {
  1574.      foreach $user (@all_users_tmp) {
  1575.        foreach $db (@all_dbs_tmp) {
  1576.          MySQLaccess::Grant::Initialize('tmp');
  1577.          %Access = MySQLaccess::Grant::Get_Access_Rights($host,$user,$db,'tmp');    
  1578.          push(@after,MySQLaccess::Report::Raw_Report($host,$user,$db,\%Access));
  1579.        }
  1580.      }
  1581.    }
  1582.  
  1583.    # ----------------------------------
  1584.    # Write results to temp-file to make
  1585.    # DIFF
  1586.    @before = sort(@before);
  1587.    @after  = sort(@after);
  1588.  
  1589.    $before = "$MySQLaccess::TMP_PATH/$MySQLaccess::script.before.$$";
  1590.    $after  = "$MySQLaccess::TMP_PATH/$MySQLaccess::script.after.$$";
  1591.    #$after = "/tmp/t0";
  1592.    open(BEFORE,"> $before") ||
  1593.     push(@MySQLaccess::Report::Errors,"Can't open temporary file $before for writing");
  1594.    open(AFTER,"> $after") ||
  1595.     push(@MySQLaccess::Report::Errors,"Can't open temporary file $after for writing");
  1596.    print BEFORE join("\n",@before);
  1597.    print AFTER  join("\n",@after);
  1598.    close(BEFORE);
  1599.    close(AFTER);
  1600.  
  1601.    # ----------------------------------
  1602.    # compute difference
  1603.    my $cmd="$MySQLaccess::DIFF $before $after |";
  1604.    open(DIFF,"$cmd");
  1605.    @diffs = <DIFF>;
  1606.    @diffs = grep(/[<>]/,@diffs);
  1607.    chomp(@diffs);
  1608.    close(DIFF);
  1609.  
  1610.    # ----------------------------------
  1611.    # cleanup temp. files
  1612.    unlink(BEFORE);
  1613.    unlink(AFTER);
  1614.  
  1615.    return \@diffs;
  1616. }
  1617.  
  1618. # ===========================================================
  1619. # sub Initialize()
  1620. #
  1621. # ===========================================================
  1622. sub Initialize {
  1623.     %MySQLaccess::Grant::Access       = %{Default_Access_Rights()};
  1624.     @MySQLaccess::Grant::Errors       = ();
  1625.     @MySQLaccess::Grant::Warnings     = ();
  1626.     @MySQLaccess::Grant::Notes        = ();
  1627.     # -----
  1628.     # rules
  1629.     $MySQLaccess::Grant::Rules{'user'} = 'no_rule_found';
  1630.     $MySQLaccess::Grant::Rules{'db'}   = 'no_rule_found';
  1631.     $MySQLaccess::Grant::Rules{'host'} = 'no_equiv_host';
  1632.     $MySQLaccess::Grant::full_access   = 1;
  1633.  
  1634.     $MySQLaccess::Grant::process_host_table = 0;
  1635.     return 1;
  1636. }
  1637.  
  1638. # ===========================================================
  1639. # sub ReadTables()
  1640. #  
  1641. # ===========================================================
  1642. sub ReadTables {
  1643.     my ($tmp) = @_;
  1644.     my ($HOST,$DB,$USER);
  1645.     my @tables;
  1646.  
  1647.     # build list of available tables
  1648.     @tables = MySQLaccess::DB::Show_Tables();
  1649.  
  1650.     # reading production grant-tables or temporary tables?
  1651.     $tmp = (defined($tmp) and $tmp) ? 1 : 0;
  1652.     if ($tmp) { #reading temporary tables
  1653.        $HOST=$MySQLaccess::ACCESS_H_TMP;
  1654.        $DB  =$MySQLaccess::ACCESS_D_TMP;
  1655.        $USER=$MySQLaccess::ACCESS_U_TMP;
  1656.  
  1657.        # ----------------------------
  1658.        # do tables exist?
  1659.        if (!grep(/$HOST/,@tables)) { MySQLaccess::DB::CreateTable($HOST); }
  1660.        if (!grep(/$USER/,@tables)) { MySQLaccess::DB::CreateTable($USER); }
  1661.        if (!grep(/$DB/,@tables))   { MySQLaccess::DB::CreateTable($DB); }
  1662.  
  1663.        MySQLaccess::Debug::Print(1,"Finding fields in tmp-ACL files:");
  1664.        # -----------------------------
  1665.        # Get record-layout 
  1666.        my ($h1,$h2) = MySQLaccess::DB::Show_Fields($HOST);
  1667.        my ($d1,$d2) = MySQLaccess::DB::Show_Fields($DB);
  1668.        my ($u1,$u2) = MySQLaccess::DB::Show_Fields($USER);
  1669.        %MySQLaccess::Grant::H_tmp = %{$h1}; @MySQLaccess::Grant::H_tmp = @{$h2};
  1670.        %MySQLaccess::Grant::D_tmp = %{$d1}; @MySQLaccess::Grant::D_tmp = @{$d2};
  1671.        %MySQLaccess::Grant::U_tmp = %{$u1}; @MySQLaccess::Grant::U_tmp = @{$u2};
  1672.  
  1673. #       @MySQLaccess::Grant::Privileges_tmp=@{Make_Privlist()};
  1674. #
  1675.        MySQLaccess::Debug::Print(1, "Reading sorted temp-tables:");
  1676.        @MySQLaccess::Grant::sorted_db_tmp_table  = MySQLaccess::DB::Sort_table($DB, 'ucase_host', 'user', 'db');
  1677.        @MySQLaccess::Grant::sorted_host_tmp_table= MySQLaccess::DB::Sort_table($HOST, 'ucase_host', 'db');
  1678.        @MySQLaccess::Grant::sorted_user_tmp_table= defined($MySQLaccess::Param{'password'}) ?
  1679.                            MySQLaccess::DB::Sort_table($USER, 'ucase_host', 'user', 'password'):
  1680.                            MySQLaccess::DB::Sort_table($USER, 'ucase_host', 'user');
  1681.     }
  1682.     else {      #reading production grant-tables
  1683.        $HOST=$MySQLaccess::ACCESS_H;
  1684.        $DB  =$MySQLaccess::ACCESS_D;
  1685.        $USER=$MySQLaccess::ACCESS_U;
  1686.  
  1687.        MySQLaccess::Debug::Print(1,"Finding fields in ACL files:");
  1688.        # -----------------------------
  1689.        # Get record-layout 
  1690.        my ($h1,$h2) = MySQLaccess::DB::Show_Fields($HOST);
  1691.        my ($d1,$d2) = MySQLaccess::DB::Show_Fields($DB);
  1692.        my ($u1,$u2) = MySQLaccess::DB::Show_Fields($USER);
  1693.        %MySQLaccess::Grant::H = %{$h1}; @MySQLaccess::Grant::H = @{$h2};
  1694.        %MySQLaccess::Grant::D = %{$d1}; @MySQLaccess::Grant::D = @{$d2};
  1695.        %MySQLaccess::Grant::U = %{$u1}; @MySQLaccess::Grant::U = @{$u2};
  1696.  
  1697.        @MySQLaccess::Grant::Privileges=@{Make_Privlist()};
  1698.  
  1699.        MySQLaccess::Debug::Print(1, "Reading sorted tables:");
  1700.        @MySQLaccess::Grant::sorted_db_table  = MySQLaccess::DB::Sort_table($DB, 'ucase_host', 'user', 'db');
  1701.        @MySQLaccess::Grant::sorted_host_table= MySQLaccess::DB::Sort_table($HOST, 'ucase_host', 'db');
  1702.        @MySQLaccess::Grant::sorted_user_table= defined($MySQLaccess::Param{'password'}) ?
  1703.                            MySQLaccess::DB::Sort_table($USER, 'ucase_host', 'user', 'password'):
  1704.                            MySQLaccess::DB::Sort_table($USER, 'ucase_host', 'user');
  1705.     }
  1706.  
  1707.     return 0;
  1708. }
  1709.  
  1710. # ===========================================================
  1711. # sub Get_Access_Rights(host,user,db)
  1712. #  report the access_rights for the tuple ($host,$user,$db).
  1713. # ===========================================================
  1714. sub Get_Access_Rights {
  1715.   local ($host,$user,$db,$tmp) = @_;
  1716.  
  1717.    my $aref_user;
  1718.    my $aref_host;
  1719.    my $aref_db;
  1720.    # working with  temporary tables or production tables
  1721.    if (defined($tmp) and $tmp) {
  1722.       $aref_user = \@MySQLaccess::Grant::sorted_user_tmp_table;
  1723.       $aref_host = \@MySQLaccess::Grant::sorted_host_tmp_table;
  1724.       $aref_db   = \@MySQLaccess::Grant::sorted_db_tmp_table;   
  1725.    }
  1726.    else {
  1727.       $aref_user = \@MySQLaccess::Grant::sorted_user_table;
  1728.       $aref_host = \@MySQLaccess::Grant::sorted_host_table;
  1729.       $aref_db   = \@MySQLaccess::Grant::sorted_db_table; 
  1730.    }
  1731.  
  1732.  
  1733.   my ($refrecord,$refgrant);
  1734.   my ($_host_,$_user_,$encpw_);
  1735.   my %_Access_;
  1736.  
  1737.   MySQLaccess::Debug::Print(1, "for ($host,$user,$db):");  
  1738.  
  1739.   # ******************************************************************************
  1740.   # Create default access-rights
  1741.   #   default access-rights are no access at all!!
  1742.  
  1743.  
  1744.   # ******************************************************************************
  1745.   # get hostname for IP-address
  1746.   # get IP-address for hostname
  1747.   local $host_name = MySQLaccess::Host::IP2Name($host);
  1748.   local $host_ip   = MySQLaccess::Host::Name2IP($host);
  1749.  
  1750.   MySQLaccess::Debug::Print(3,"host=$host, hostname=$host_name, host-ip =$host_ip");
  1751.   MySQLaccess::Debug::Print(3,"user=$user");
  1752.   MySQLaccess::Debug::Print(3,"db  =$db");
  1753.  
  1754.   # ***********************************************************************
  1755.   # retrieve information on USER
  1756.   #  check all records in mysql::user for matches with the tuple (host,user)
  1757.   # ***********************************************************************
  1758.   #    4.OR (add) the privileges for the user from the "user" table.
  1759.   #     (add all privileges which is "Y" in "user")
  1760.   ($refrecord,$refgrant)    = Get_grant_from_user($host,$user,$aref_user);
  1761.   ($_host_,$_user_,$encpw_) = @{$refrecord};
  1762.   %_access_                 = %{$refgrant};
  1763.  
  1764.   foreach $field (keys(%U)) { ##only priv. set in user-table
  1765.     $MySQLaccess::Grant::Access{$field} = ($MySQLaccess::Grant::Access{$field} or $_access_{$field});
  1766.   }
  1767.  
  1768.   if ($_user_ eq $MySQLaccess::NEW_USER) { 
  1769.      push(@Warnings,'minimum_priv');
  1770.   }
  1771.   if ($_user_ ne $user) {
  1772.      $user=$_user_;
  1773.      push(@Warnings,'anonymous_access');
  1774.   }
  1775.  
  1776.   # *******************************************************
  1777.   #  Validate password if this has been asked to do
  1778.   # *******************************************************
  1779.   if (defined($password)) {
  1780.      $valid = Validate_Password($password,$_host_,$_user_,$_encpw_,$aref_user);
  1781.      if (!$valid) { push(@Errors,'invalid_password'); }
  1782.      else         { push(@Notes,'valid_password'); }
  1783.   }
  1784.  
  1785.   # ******************************************************************************
  1786.   # retrieve information on DB
  1787.   #  check all records in mysql::db for matches with the triple (host,db,user)
  1788.   #  first match is used.
  1789.   # ******************************************************************************
  1790.   #    2.Get grant for user from the "db" table.
  1791.  
  1792.   ($refrecord,$refgrant)=Get_grant_from_db($host,$db,$user,$aref_db); #set process_host_table
  1793.   ($_host_,$_user_,$encpw_) = @{$refrecord};
  1794.   %_access_                 = %{$refgrant};
  1795.  
  1796.   foreach $field (keys(%D)) { ##only priv. set in db-table
  1797.     $MySQLaccess::Grant::Access{$field} = ($MySQLaccess::Grant::Access{$field} or $_access_{$field});
  1798.   }
  1799.  
  1800.   # ***********************************************************************
  1801.   # retrieve information on HOST
  1802.   #  check all records in mysql::host for matches with the tuple (host,db)
  1803.   #
  1804.   #  ' The host table is mainly to maintain a list of "secure" servers. '
  1805.   # ***********************************************************************
  1806.   #    3.If hostname is "empty" for the found entry, AND the privileges with
  1807.   #      the privileges for the host in "host" table.
  1808.   #      (Remove all which is not "Y" in both)
  1809.  
  1810.   if ($MySQLaccess::Grant::process_host_table) {
  1811.      ($refrecord,$refgrant)=Get_grant_from_host($host,$db,$aref_host);
  1812.      ($_host_,$_user_,$encpw_) = @{$refrecord};
  1813.      %_access_                 = %{$refgrant};
  1814.  
  1815.      foreach $field (keys(%H)) {  ##only priv. set in host-table 
  1816.        $MySQLaccess::Grant::Access{$field} = ($MySQLaccess::Grant::Access{$field} and $_access_{$field});
  1817.      } 
  1818.   }
  1819.  
  1820.   MySQLaccess::Debug::Print(1,"done for ($host,$user,$db)");
  1821.   return %MySQLaccess::Grant::Access;
  1822. }
  1823.  
  1824. # ####################################
  1825. # FINDING THE RIGHT GRANT-RULE
  1826. # ==========================================================
  1827. # sub Get_grant_from_user:
  1828. # ==========================================================
  1829. sub Get_grant_from_user {
  1830.   my ($host,$user,$aref) = @_;
  1831.  
  1832.   MySQLaccess::Debug::Print(1, "");
  1833.   MySQLaccess::Debug::Print(1, "(host=$host,user=$user)");
  1834.  
  1835.   my %Access_user = %{Default_Access_Rights()}; 
  1836.  
  1837.   my $rule_found=0;
  1838.   my @record = ();
  1839.   my $record;
  1840.  
  1841.   foreach $record (@{$aref}) {
  1842.     $MySQLaccess::Grant::full_access=0;
  1843.     MySQLaccess::Debug::Print(3, "Record= $record");
  1844.     @record=split(/\t/,$record);
  1845.  
  1846.     # check host and db
  1847.     # with possible wildcards in field
  1848.     # replace mysql-wildcards by reg-wildcards
  1849.     my $host_tpl = MySQLaccess::Wildcards::SQL2Reg($record[0]);
  1850.     my $user_tpl = $record[1]; #user field isn't pattern-matched!!
  1851.     my $passwd   = $record[2];
  1852.  
  1853.     MySQLaccess::Debug::Print(3, "=>host_tpl : read=$record[0] -> converted=$host_tpl");
  1854.     MySQLaccess::Debug::Print(3, "=>user_tpl : read=$record[1] -> $user_tpl");
  1855.     MySQLaccess::Debug::Print(3, "=>password : read=$record[2] -> $passwd");
  1856.  
  1857.  
  1858.     if ( MySQLaccess::Host::MatchTemplate($host,$host_tpl) and
  1859.          MySQLaccess::Wildcards::MatchTemplate($user_tpl,$user)
  1860.        ) 
  1861.     {
  1862.   MySQLaccess::Debug::Print(2, "FOUND!!");
  1863.         if ($passwd eq '') { push(@Warnings,'insecure_user');  }
  1864.         else               { push(@Notes,'password_required'); }
  1865.  
  1866.         foreach $field (keys(%U)) {
  1867.           $Access_user{$field} = $MySQLaccess::Report::Answer{$record[$U{$field}]};
  1868.         }
  1869.         #print "\n" if $DEBUG;
  1870.         $MySQLaccess::Grant::Rules{'user'} = $record;
  1871.         $rule_found=1;
  1872.         last;
  1873.     }
  1874.   }
  1875.  
  1876.   # -------------------------------
  1877.   #  setting privileges to user-priv
  1878.   MySQLaccess::Debug::Print(2, "Rights after parsing user-table..:");
  1879.   if (! $rule_found ) {
  1880.      @record=();
  1881.      MySQLaccess::Debug::Print(2, "NO record found in the user-table!!");
  1882.   }
  1883.   else {
  1884.      MySQLaccess::Debug::Print(2, "Selected record=@record");
  1885.      MySQLaccess::Debug::Print(2, "<=?=> $record");
  1886.   }
  1887.  
  1888.   MySQLaccess::Debug::Print(1, "returning @record");
  1889.  
  1890.   return (\@record,\%Access_user); #matching record in user-table
  1891. }
  1892.  
  1893. # ==========================================================
  1894. # sub Get_grant_from_db:
  1895. # ==========================================================
  1896. sub Get_grant_from_db {
  1897.   my ($host,$db,$user,$aref) = @_;
  1898.  
  1899.   MySQLaccess::Debug::Print(1, "(host=$host,user=$user,db=$db)");
  1900.  
  1901.   my %Access_db    = %{Default_Access_Rights()};
  1902.   my $rule_found=0;
  1903.  
  1904.   foreach $record (@{$aref}) {
  1905.     $full_access=0;
  1906.     MySQLaccess::Debug::Print(2, "Read db: $record");
  1907.     @record=split(/\t/,$record);
  1908.  
  1909.     # check host and db
  1910.     # with possible wildcards in field
  1911.     # replace mysql-wildcards by reg-wildcards
  1912.     my $host_tpl = MySQLaccess::Wildcards::SQL2Reg($record[0]);
  1913.     my $db_tpl   = MySQLaccess::Wildcards::SQL2Reg($record[1]);
  1914.     my $user_tpl = $record[2]; #user field isn't pattern matched!!
  1915.     MySQLaccess::Debug::Print(3, "=>host_tpl : read=$record[0] -> converted=$host_tpl");
  1916.     MySQLaccess::Debug::Print(3, "=>db_tpl   : read=$record[1] -> $db_tpl");
  1917.     MySQLaccess::Debug::Print(3, "=>user_tpl : read=$record[2] -> $user_tpl");
  1918.  
  1919.     if ( ( MySQLaccess::Host::Is_localhost($host_tpl)
  1920.            or  MySQLaccess::Wildcards::MatchTemplate($host_tpl,$host_name)
  1921.            or  MySQLaccess::Wildcards::MatchTemplate($host_tpl,$host_ip) )
  1922.          and ( MySQLaccess::Wildcards::MatchTemplate($db_tpl,$db) )
  1923.          and ( MySQLaccess::Wildcards::MatchTemplate($user_tpl,$user) ) ) {
  1924.  
  1925.       $MySQLaccess::Grant::process_host_table = ($record[0] eq '');
  1926.  
  1927.       if ($user_tpl eq '') { push(@Warnings,'public_database'); }
  1928.  
  1929.       foreach $field (keys(%D)) {
  1930.         $Access_db{$field} = $MySQLaccess::Report::Answer{$record[$D{$field}]};
  1931.       }
  1932.       $rule_found=1;
  1933.       $MySQLaccess::Grant::Rules{'db'} = $record;
  1934.       last;
  1935.     }
  1936.   }
  1937.  
  1938.   # -------------------------------
  1939.   #  setting privileges to db-priv
  1940.   MySQLaccess::Debug::Print(2, "Rights after parsing db-table..:");
  1941.   if (! $rule_found ) {
  1942.     MySQLaccess::Debug::Print(2, "NO rule found in db-table => no access granted!!");
  1943.   }
  1944.  
  1945.   return (\@record,\%Access_db);
  1946. }
  1947.  
  1948. # ==========================================================
  1949. # sub Get_grant_from_host:
  1950. # ==========================================================
  1951. sub Get_grant_from_host {
  1952.   my ($host,$db,$aref) = @_;
  1953.  
  1954.   MySQLaccess::Debug::Print(1, "Get_grant_from_host()");
  1955.  
  1956.   my %Access_host = %{Default_Access_Rights()};
  1957.  
  1958.   # the host-table doesn't have to be processed if the host-field
  1959.   # in the db-table isn't empty
  1960.   if (!$MySQLaccess::Grant::process_host_table) {
  1961.     MySQLaccess::Debug::Print(2, ">> Host-table doesn't have to be processed!!");
  1962.     $MySQLaccess::Grant::Rules{'host'} = 'no_equiv_host';
  1963.     return ([],\%Access_host);
  1964.   }
  1965.  
  1966.   my $rule_found=0;
  1967.   my @record = ();
  1968.  
  1969.   foreach $record (@{$aref}) {
  1970.     $full_access=0;
  1971.     MySQLaccess::Debug::Print(2, "host: $record");
  1972.     @record=split(/\t/,$record);
  1973.  
  1974.     # check host and db
  1975.     # with possible wildcards in field
  1976.     # replace mysql-wildcards by reg-wildcards
  1977.     my $host_tpl = MySQLaccess::Wildcards::SQL2Reg($record[0]);
  1978.     my $db_tpl   = MySQLaccess::Wildcards::SQL2Reg($record[1]);
  1979.     MySQLaccess::Debug::Print(3, "=>host_tpl : $record[0] -> $host_tpl");
  1980.     MySQLaccess::Debug::Print(3, "=>db_tpl   : $record[1] -> $db_tpl");
  1981.  
  1982.     if ( ( MySQLaccess::Host::Is_localhost($host_tpl)
  1983.            or MySQLaccess::Wildcards::MatchTemplate($host_tpl,$host_name)
  1984.            or MySQLaccess::Wildcards::MatchTemplate($host_tpl,$host_ip) )
  1985.          and ( MySQLaccess::Wildcards::MatchTemplate($db_tpl,$db) ) ) {
  1986.  
  1987.       $MySQLaccess::Grant::Rules{'host'} = $record;
  1988.       $rule_found=1;
  1989.       foreach $field (keys(%H)) {
  1990.         $Access_host{$field} = $MySQLaccess::Report::Answer{$record[$H{$field}]};
  1991.       }
  1992.       last;
  1993.     }
  1994.   }
  1995.  
  1996.   # -------------------------------
  1997.   #  setting privileges to host-priv
  1998.   MySQLaccess::Debug::Print(2, "Rights after parsing host-table..:");
  1999.   if (! $rule_found ) {
  2000.      @record=();
  2001.      MySQLaccess::Debug::Print(2, "NO restrictions found in the host-table!!");
  2002.   }
  2003.  
  2004.   # --------------------------------
  2005.   # debugging access-rights in db 
  2006.  
  2007.   return (\@record,\%Access_host); #matching record in host-table
  2008. }
  2009.  
  2010.  
  2011.  
  2012. # ===========================================================
  2013. # sub Default_Access_Rights():
  2014. #  return (a reference to) a hash which holds all default
  2015. #  priviliges currently defined in the grant-tables.
  2016. # ===========================================================
  2017. sub Default_Access_Rights {
  2018.     my %right = ();
  2019.  
  2020.     MySQLaccess::Debug::Print(2, "Debug Default_Access_Rights():");
  2021.     # add entry for all fields in the HOST-table
  2022.     foreach $field (keys(%MySQLaccess::Grant::H)) {
  2023.     $right{$field}='0' unless (defined($right{$field}));
  2024.     }
  2025.     # add entry for all fields in the DB-table
  2026.     foreach $field (keys(%MySQLaccess::Grant::D)) {
  2027.     $right{$field}='0' unless (defined($right{$field}));
  2028.     }
  2029.     # add entry for all fields in the USER-table
  2030.     foreach $field (keys(%MySQLaccess::Grant::U)) {
  2031.     $right{$field}='0' unless (defined($right{$field}));
  2032.     }
  2033.     # --------------
  2034.     # debugging info
  2035.     foreach $field (keys(%right)) { MySQLaccess::Debug::Print(3, sprintf("> %15s : %1s",$field,$right{$field})); }
  2036.  
  2037.     return \%right;
  2038. }
  2039.  
  2040. # ======================================
  2041. # sub Make_Privlist
  2042. #  Make an ordered list of the privileges
  2043. #  that should be reported
  2044. # ======================================
  2045. sub Make_Privlist {
  2046.     # layout:
  2047.     #'select_priv',     'create_priv',
  2048.     #'insert_priv',     'drop_priv',
  2049.     #'update_priv',     'reload_priv',
  2050.     #'delete_priv',     'process_priv',
  2051.     #'file_priv',       'shutdown_priv');
  2052.     my $right;
  2053.     my @privlist=();
  2054.     foreach $right (@U) {
  2055.     if (! grep(/$right/,@privlist)) { push(@privlist,$right); }
  2056.     };
  2057.     foreach $right (@D) {
  2058.     if (! grep(/$right/,@privlist)) { push(@privlist,$right); }
  2059.     };
  2060.     foreach $right (@H) {
  2061.     if (! grep(/$right/,@privlist)) { push(@privlist,$right); }
  2062.     };
  2063. #       print "Privileges:\n";
  2064. #       foreach $field (@privlist) { print " > $field\n"; }
  2065.     return \@privlist;
  2066. }
  2067.  
  2068.  
  2069.  
  2070. ########################################################################
  2071. package MySQLaccess::Report;
  2072. use Exporter ();
  2073. @EXPORT = qw(&Print_Header());
  2074. BEGIN {
  2075.     $FORM = $ENV{'SCRIPT_NAME'};
  2076.     $DEBUG     = 0;
  2077.     $DEBUG     = $MySQLaccess::DEBUG unless ($DEBUG);
  2078.  
  2079.     # translation-table for poss. answers
  2080.     %Answer =  ('Y' =>  1 , 'N' =>  0
  2081.                , 1  => 'Y',  0  => 'N'
  2082.                ,'?' => '?', ''  => '?'
  2083.                );
  2084.     $headers   = 0;
  2085.     $separator = 0;
  2086.  
  2087. # ****************************
  2088. # Notes and warnings
  2089. %MESSAGES = ( 
  2090.   'insecure_user' 
  2091.    => "Everybody can access your DB as user `\$user' from host `\$host'\n"
  2092.      ."WITHOUT supplying a password.\n"
  2093.      ."Be very careful about it!!"
  2094.  ,'password_required' 
  2095.    => "A password is required for user `\$user' :-("
  2096.  ,'invalid_password'
  2097.    => "The password '\$password' for user `\$user' is invalid :-P"
  2098.  , 'valid_password'
  2099.    => "You supplied the right password for user `\$user' :-)"
  2100.  ,'public_database' 
  2101.    => "Any user with the appropriate permissions has access to your DB!\n"
  2102.      ."Check your users!"
  2103.  ,'full_access' 
  2104.    => "All grant-tables are empty, which gives full access to ALL users !!"
  2105.  ,'no_rule_found'
  2106.    => "No matching rule"
  2107.  ,'no_equiv_host' 
  2108.    => "Not processed: host-field is not empty in db-table."
  2109.  ,'least_priv'
  2110.    => "If the final priveliges of the user are more then you gave the user,\n"
  2111.      ."check the priveliges in the db-table `\$db'."
  2112.  ,'minimum_priv'
  2113.    => "The privileges for any new user are AT LEAST\n"
  2114.      ."the ones shown in the table above,\n"
  2115.      ."since these are the privileges of the db `\$db'.\n"
  2116.  ,'not_found_mysql'
  2117.    => "The MySQL client program <$MySQLaccess::MYSQL> could not be found.\n"
  2118.      ."+ Check your path, or\n"
  2119.      ."+ edit the source of this script to point \$MYSQL to the mysql client.\n"
  2120.  ,'not_found_mysqldump'
  2121.    => "The MySQL dump program <$MySQLaccess::MYSQLDUMP> could not be found.\n"
  2122.      ."+ Check your path, or\n"
  2123.      ."+ edit the source of this script to point \$MYSQLDUMP to the mysqldump program.\n"
  2124.  ,'not_found_diff'
  2125.    => "The diff program <$MySQLaccess::DIFF> could not be found.\n"
  2126.      ."+ Check your path, or\n"
  2127.      ."+ edit the source of this script to point \$DIFF to the diff program.\n"
  2128.  ,'not_found_tmp'
  2129.    => "The temporary directory <$MySQLaccess::TMP_PATH> could not be found.\n"
  2130.      ."+ create this directory (writeable!), or\n"
  2131.      ."+ edit the source of this script to point \$TMP_PATH to the right directory.\n"
  2132.  ,'write_err_tmp'
  2133.    => "The temporary directory <$MySQLaccess::TMP_PATH> is not writable.\n"
  2134.      ."+ make this directory writeable!, or\n"
  2135.      ."+ edit the source of this script to point \$TMP_PATH to another directory.\n"
  2136.  ,'Unrecognized_option'
  2137.    => "Sorry,\n"
  2138.      ."You are using an old version of the mysql-program,\n"
  2139.      ."which does not yet implement a neccessary option.\n"
  2140.      ."\n"
  2141.      ."You need at least Version 6.2 of the mysql-client,\n"
  2142.      ."which was build in MySQL v3.0.18, to use this version\n"
  2143.      ."of `$MySQLaccess::script'."
  2144.  ,'Access_denied'
  2145.    => "Sorry,\n"
  2146.      ."An error occured when trying to connect to the database\n"
  2147.      ."with the grant-tables:\n"
  2148.      ."* Maybe YOU do not have READ-access to this database?\n"
  2149.      ."* If you used the -U option, you may have supplied an invalid username?\n"
  2150.      ."  for the superuser?\n"
  2151.      ."* If you used the -U option, it may be possible you have to supply\n"
  2152.      ."  a superuser-password to, with the -P option?\n"
  2153.      ."* If you used the -P option, you may have supplied an invalid password?\n"
  2154.  ,'Dbaccess_denied'
  2155.    => "Sorry,\n"
  2156.      ."An error occured when trying to connect to the database\n"
  2157.      ."with the grant-tables. (dbaccess denied)\n"
  2158.  ,'Unknown_tmp_table'
  2159.    => "Sorry,\n"
  2160.      ."An error occured when trying to work with the temporary tables in the database\n"
  2161.      ."with the grant-tables. (One of the temporary tables does not exist)\n"
  2162.  ,'Unknown_table'
  2163.    => "Sorry,\n"
  2164.      ."An error occured when trying to work with some tables in the database\n"
  2165.      ."with the grant-tables. (table does not exist)\n"
  2166.  ,'use_old_server'
  2167.    => "Sorry,\n"
  2168.      ."An error occured when executing an SQL statement.\n"
  2169.      ."You might consider altering the use of the parameter `--old_server' when \n"
  2170.      ."calling `$MySQLaccess::script'."
  2171.  ,'unknown_error'
  2172.    => "Sorry,\n"
  2173.      ."An error occured when trying to connect to the database\n"
  2174.      ."with the grant-tables. (unknown error)\n"
  2175.  ,'anonymous_access'
  2176.    => "Accessing the db as an anonymous user.\n"
  2177.      ."Your username has no relevance\n"
  2178.  ,'user_required'
  2179.    => "You have to supply a userid."
  2180.  ,'db_required'
  2181.    => "You have to supply the name of a database."
  2182.  ,'host_required'
  2183.    => "You have to supply the name of a host."
  2184.  );
  2185.  
  2186.  
  2187. } 
  2188. # =====================================
  2189. # sub Print_Header:
  2190. #  print header info
  2191. # =====================================
  2192. sub Print_Header {
  2193.     if ($MySQLaccess::CMD) { #command-line mode
  2194.     print "$MySQLaccess::script Version $MySQLaccess::VERSION\n"
  2195.          ."By RUG-AIV, by Yves Carlier (Yves.Carlier\@rug.ac.be)\n"
  2196.          ."This software comes with ABSOLUTELY NO WARRANTY.\n";
  2197.     }
  2198.     if ($MySQLaccess::CGI) { #CGI-BIN mode
  2199.     print "content-type: text/html\n\n" 
  2200.        . "<HTML>\n"
  2201.          ."<HEAD>\n"
  2202.          ."<TITLE>MySQLaccess</TITLE>\n"
  2203.          ."</HEAD>\n"
  2204.          ."<BODY>\n"
  2205.          ."<H1>$MySQLaccess::script Version $MySQLaccess::VERSION</H1>\n" 
  2206.          ."<CENTER>\n<ADDRESS>\n"
  2207.          ."By RUG-AIV, by Yves Carlier (<a href=mailto:Yves.Carlier\@rug.ac.be>Yves.Carlier\@rug.ac.be</a>)<BR>\n"
  2208.          ."This software comes with ABSOLUTELY NO WARRANTY.<BR>\n"
  2209.          ."</ADDRESS>\n</CENTER>\n"
  2210.          ."<HR>\n";
  2211.     Print_Taskbar();
  2212.     print "<HR>\n";
  2213.     }
  2214.     return 1;
  2215. }
  2216.  
  2217. # =====================================
  2218. # sub Print_Footer:
  2219. #  print footer info
  2220. # =====================================
  2221. sub Print_Footer {
  2222.     if ($MySQLaccess::CMD) { #command-line mode
  2223.     print "\n"
  2224.          ."BUGs can be reported by email to Yves.Carlier\@rug.ac.be\n";
  2225.     }
  2226.     if ($MySQLaccess::CGI) { #CGI-BIN mode
  2227.     if ($MySQLaccess::Param{'brief'}) {
  2228.     print "</table>\n";  #close table in brief-output
  2229.     }
  2230.     print "<HR>\n"
  2231.          ."<ADDRESS>\n"
  2232.          ."BUGs can be reported by email to <a href=mailto:Yves.Carlier\@rug.ac.be>Yves.Carlier\@rug.ac.be</a><BR>\n"
  2233. #         ."Don't forget to mention the version $VERSION!<BR>\n"
  2234.          ."</ADDRESS>\n"
  2235.          ."</BODY>\n"
  2236.          ."</HTML>\n";
  2237.     }
  2238.     return 1;
  2239. }
  2240.  
  2241. # =====================================
  2242. # sub Print_Taskbar:
  2243. #  print taskbar on STDOUT
  2244. # =====================================
  2245. sub Print_Taskbar {
  2246.     print "<CENTER>\n"
  2247.          ."[<a href=$FORM?relnotes=on>Release Notes</a>] \n"
  2248.          ."[<a href=$FORM?version=on>Version</a>] \n"
  2249.          ."[<a href=$FORM?plan=on>Future Plans</a>] \n"
  2250.          ."[<a href=$FORM?howto=on>Examples</a>] \n"
  2251.          ."[<a href=$FORM?help=on>New check</a>] \n"
  2252.          ."[<a href=$FORM?edit=on>Change/edit ACL</a>] \n"
  2253.          ."</CENTER>\n";
  2254.     return 1;
  2255. }
  2256.  
  2257. # =====================================
  2258. # sub Print_Form:
  2259. #  print CGI-form
  2260. # =====================================
  2261. sub Print_Form {
  2262. print <<EOForm;
  2263. <center>
  2264. <!-- Quering -->
  2265. <FORM method=POST action=$FORM>
  2266.  
  2267. <table border width="100%" >
  2268. <tr>
  2269.   <th>MySQL server</th>
  2270.   <th>User information</th>
  2271.   <th>Reports</th>
  2272.   </tr>
  2273.  
  2274. <tr>
  2275.   <td valign=top>
  2276.   <table>
  2277.   <tr>
  2278.     <td halign=right><b>Host</b><br><font size=-2>(Host on which MySQL-server resides.)</font></td>
  2279.     <td valign=top><INPUT name=rhost type=text size=15 maxlength=15 value="$MySQLaccess::Param{'rhost'}"></td>
  2280.     </tr>
  2281.   <tr>
  2282.     <td halign=right><b>Superuser</b><br><font size=-2>(User which has <font color="Red">read-access</font> to grant-tables.)</font></td>
  2283.     <td valign=top><INPUT name=superuser type=text size=15 maxlength=15 value="$MySQLaccess::Param{'superuser'}"></td>
  2284.     </tr>
  2285.   <tr>
  2286.     <td halign=right><b>Password</b><br><font size=-2>(of Superuser.)</font></td>
  2287.     <td valign=top><INPUT name=spassword type=password size=15 maxlength=15 value="$MySQLaccess::Param{'spassword'}"></td>
  2288.     </tr>
  2289.   </table>
  2290.   </td>
  2291.  
  2292.   <td valign=top>
  2293.   <table>
  2294.   <tr>
  2295.     <td halign=right><b><font color=Red>User</font></b><br><font size=-2>(Userid used to connect to MySQL-database.)</font></td>
  2296.     <td halign=top><INPUT name=user type=text size=15 maxlength=15 value="$MySQLaccess::Param{'user'}"></td>
  2297.     </tr>
  2298.   <tr>
  2299.     <td halign=right><b>Password</b><br><font size=-2>(Password user has to give to get access to MySQL-database.)</font></td>
  2300.     <td valign=top><INPUT name=password type=password size=15 maxlength=15 value="$MySQLaccess::Param{'password'}"></td>
  2301.     </tr>
  2302.   <tr>
  2303.     <td halign=right><b><font color=Red>Database</font></b><br><font size=-2>(Name of MySQL-database user tries to connect to.</font><br><font size=-2>Wildcards <font color="Green">(*,?,%,_)</font> are allowed.)</font></td>
  2304.     <td valign=top><INPUT name=db type=text size=15 maxlength=15 value="$MySQLaccess::Param{'db'}"></td>
  2305.     </tr>
  2306.   <tr>
  2307.     <td halign=right><b>Host</b><br><font size=-2>(Host from where the user is trying to connect to MySQL-database.</font><br><font size=-2>Wildcards <font color="Green">(*,?,%,_)</font> are allowed.)</font></td>
  2308.     <td valign=top><INPUT name=host type=text size=15 maxlength=15 value="$MySQLaccess::Param{'host'}"></td>
  2309.     </tr>
  2310.   </table>
  2311.   </td>
  2312.  
  2313.   <td valign=center>
  2314.   <table cellspacing=5 cellpadding=2 cols=1 height="100%">
  2315.   <tr align=center>
  2316.     <td halign=right><INPUT type=submit name=brief value="Brief"><br>
  2317.                      <INPUT type=submit name=table value="Tabular"></td>
  2318.     </tr>
  2319.   <tr align=center>
  2320.     <td></td>
  2321.     </tr>
  2322.   <tr align=center>
  2323.     <td halign=right><INPUT type=reset value="Clear"></td>
  2324.     </tr>
  2325.   </table>
  2326.   </td>
  2327.   </tr>
  2328.  
  2329. </table>
  2330. </form>
  2331.  
  2332.  
  2333. </BODY>
  2334. </HTML>
  2335. EOForm
  2336.     return 1;
  2337. }
  2338.  
  2339. # =====================================
  2340. # sub Print_Usage:
  2341. #  print some information on STDOUT
  2342. # =====================================
  2343. sub Print_Usage {
  2344.     Print_Error_Messages();
  2345.     if ($MySQLaccess::CMD) { #command-line mode
  2346.         Print_Options();
  2347.     }
  2348.     if ($MySQLaccess::CGI) { #CGI-BIN mode
  2349.         Print_Form();
  2350.     }    
  2351.     return 1;
  2352. }
  2353.  
  2354. # ======================================
  2355. # sub Print_Version:
  2356. # ======================================
  2357. sub Print_Version {
  2358.     if ($MySQLaccess::CMD) {
  2359.        print $MySQLaccess::INFO;
  2360.     }
  2361.     if ($MySQLaccess::CGI) { 
  2362.        print "<PRE>\n"; 
  2363.        print $MySQLaccess::INFO;
  2364.        print "</PRE>\n"; 
  2365.     }
  2366.     return 1;
  2367. }
  2368.  
  2369. # ======================================
  2370. # sub Print_Relnotes:
  2371. # ======================================
  2372. sub Print_Relnotes {
  2373.     if ($MySQLaccess::CMD) {
  2374.        print $MySQLaccess::RELEASE;
  2375.     }
  2376.     if ($MySQLaccess::CGI) { 
  2377.        print "<PRE>\n";
  2378.        print $MySQLaccess::RELEASE;
  2379.        print "</PRE>\n"; 
  2380.     }
  2381.     return 1;
  2382. }
  2383.  
  2384. # ======================================
  2385. # sub Print_Plans:
  2386. # ======================================
  2387. sub Print_Plans {
  2388.     if ($MySQLaccess::CMD) {
  2389.        print $MySQLaccess::TODO;
  2390.     }
  2391.     if ($MySQLaccess::CGI) { 
  2392.        print "<PRE>\n";
  2393.        print $MySQLaccess::TODO;
  2394.        print "</PRE>\n"; 
  2395.     }
  2396.     return 1;
  2397. }
  2398.  
  2399. # ======================================
  2400. # sub Print_HowTo:
  2401. # ======================================
  2402. sub Print_HowTo {
  2403.     if ($MySQLaccess::CMD) {
  2404.        print $MySQLaccess::HOWTO;
  2405.     }
  2406.     if ($MySQLaccess::CGI) { 
  2407.        print "<PRE>\n"; 
  2408.        print $MySQLaccess::HOWTO;
  2409.        print "</PRE>\n"; 
  2410.     }
  2411.     return 1;
  2412. }
  2413.  
  2414. # ======================================
  2415. # sub Print_Options:
  2416. # ======================================
  2417. sub Print_Options {
  2418.     if ($MySQLaccess::CGI) { print "<PRE>\n"; }
  2419.     print $MySQLaccess::OPTIONS;
  2420.     if ($MySQLaccess::CGI) { print "</PRE>\n"; }
  2421.     return 1;
  2422. }
  2423.  
  2424. # ======================================
  2425. # sub Print_Error_Access:
  2426. # ======================================
  2427. sub Print_Error_Access {
  2428.     my ($error) = @_;
  2429.     print "\n";
  2430.     if ($MySQLaccess::CGI) { print "<font color=Red>\n<PRE>\n"; }
  2431.     print $MESSAGES{$error};
  2432.     if ($MySQLaccess::CGI) { print "</PRE>\n</font>\n"; }
  2433.     print "\n";
  2434.     return 1;
  2435. }
  2436.  
  2437. # ======================================
  2438. # sub Print_Error_Messages:
  2439. # ======================================
  2440. sub Print_Error_Messages {
  2441. #    my ($error) = @_;
  2442.     print "\n";
  2443.     if ($MySQLaccess::CGI) { print "<font color=Red>\n<center>\n"; }
  2444.     foreach $error (@MySQLaccess::Grant::Error) {
  2445.        print $MESSAGES{$error};
  2446.        print $MySQLaccess::CGI ? "<br>\n" : "\n";
  2447.     }
  2448.     if ($MySQLaccess::CGI) { print "</center>\n</font>\n"; }
  2449.     print "\n";
  2450.     return 1;
  2451. }
  2452.  
  2453. # ======================================
  2454. # sub Print_Message:
  2455. # ======================================
  2456. sub Print_Message {
  2457.     my ($aref) = @_;
  2458.     my @messages = @{$aref};
  2459.     print "\n";
  2460.     if ($MySQLaccess::CGI) { print "<font color=DarkGreen>\n<center>\n"; }
  2461.     foreach $msg (@messages) {
  2462.        print $msg;
  2463.        print $MySQLaccess::CGI ? "<br>\n" : "\n";
  2464.     }
  2465.     if ($MySQLaccess::CGI) { print "</center>\n</font>\n"; }
  2466.     print "\n";
  2467.     return 1;
  2468. }
  2469.  
  2470. # ======================================
  2471. # sub Print_Edit:
  2472. # ======================================
  2473. sub Print_Edit {
  2474.     print "\n";
  2475.     if (!$MySQLaccess::CGI) { 
  2476.        print "Note: Editing the temporary tables is NOT supported in CMD-line mode!\n";
  2477.        return 0;
  2478.     }
  2479.     print "<CENTER>\n"
  2480.          ."<form action=$FORM method=GET>\n"
  2481.          ."<table width=90% border>\n"
  2482.          ."<tr>\n"
  2483.          ." <td><input type=checkbox name=copy value=on> Copy grant-rules to temporary tables<br></td>\n"
  2484.          ." <td rowspan=5 align=center valign=center><input type=submit value=Go></td>\n"
  2485.          ."</tr>\n"
  2486.          ."<tr>\n"
  2487.          ." <td> Edit temporary tables with external application:<br>"
  2488.          ." <a href=\"$MySQLaccess::MYSQLADMIN\">$MySQLaccess::MYSQLADMIN</a></td>\n"
  2489.          ."</tr>\n"
  2490.          ."<tr>\n"
  2491.          ." <td><input type=checkbox name=preview value=on> Preview changes made in temporary tables</td>\n"
  2492.          ."</tr>\n"
  2493.          ."<tr>\n"
  2494.          ." <td><input type=checkbox name=commit value=on> Make changes permanent</td>\n"
  2495.          ."</tr>\n"
  2496.          ."<tr>\n"
  2497.          ." <td><input type=checkbox name=rollback value=on> Restore previous grand-rules</td>\n"
  2498.          ."</tr>\n"
  2499.          ."<tr>\n"
  2500.          ." <td colspan=2 align=center><font size=-2 color=Red>You need write,delete and drop-privileges to perform the above actions</font></td>\n"
  2501.          ."</tr>\n"
  2502.          ."</table>\n"
  2503.          ."</form>\n"
  2504.          ."</CENTER>\n";
  2505.  
  2506.     return 1;
  2507. }
  2508.  
  2509.  
  2510. # ======================================
  2511. # sub Print_Access_rights:
  2512. #  print the access-rights on STDOUT
  2513. # ======================================
  2514. sub Print_Access_rights {
  2515.     my ($host,$user,$db,$refhash) = @_;
  2516.  
  2517.     if (defined($MySQLaccess::Param{'brief'})) { 
  2518. #       if ($MySQLaccess::CGI) { print "<PRE>\n"; }
  2519.        Matrix_Report($host,$user,$db,$refhash);  
  2520. #       if ($MySQLaccess::CGI) { print "</PRE>\n"; }
  2521.     }
  2522.     else { 
  2523.        Tabular_Report($host,$user,$db,$refhash); 
  2524.        $MySQLaccess::Report::separator = $MySQLaccess::CGI ? "<hr>" : "-"x80;
  2525.     }
  2526.     return 1;
  2527. }
  2528.  
  2529. # ======================================
  2530. # sub Print_Diff_ACL:
  2531. #  print the diff. in the grants before and after
  2532. # ======================================
  2533. sub Print_Diff_ACL {
  2534.     my ($aref) = @_;
  2535.     my @diffs = @{$aref};
  2536.     my %block = ( '<' => 'Before',
  2537.                   '>' => 'After',
  2538.                 );
  2539.     my %color = ( '<' => 'Green',
  2540.                   '>' => 'Red',
  2541.                 ); 
  2542.     my $curblock = '';
  2543.  
  2544.     # -----------------------------
  2545.     # create column-headers
  2546.     foreach $field (@MySQLaccess::Grant::Privileges) {
  2547.       push(@headers,substr($field,0,4));
  2548.     }
  2549.  
  2550.     if ($MySQLaccess::CMD) {
  2551.     print "\n";
  2552.     print "Differences in access-rights BEFORE and AFTER changes in grant-tables\n";
  2553. #    print "---------------------------------------------------------------------\n";
  2554.       my $line1="";
  2555.       my $line2="";
  2556.       $line1 .= sprintf("| %-30s|",'Host,User,DB');
  2557.       $line2 .= sprintf("+-%-30s+",'-' x 30);
  2558.       foreach $header (@headers) {
  2559.         $line1 .= sprintf("%-4s|",$header);
  2560.         $line2 .= sprintf("%s+",'----');
  2561.       }
  2562.       print "$line2\n";
  2563.       print "$line1\n";
  2564.       print "$line2\n";
  2565.  
  2566.       $format = "format STDOUT = \n"
  2567.               . "^<<<<<<<<<<<<<<<<<<<<<<<<<<<<<< " . " @|||" x 10 ."\n"
  2568.               . '$host_user_db,@priv' . "\n"
  2569.               . ".\n";
  2570. #print $format;
  2571.       eval $format;
  2572.     }
  2573.     if ($MySQLaccess::CGI) {
  2574.     print "<table border width=100%>\n";
  2575.     print "<tr>\n";
  2576.     print "<th colspan=11>";
  2577.     print "Differences in access-rights <font color=$color{'<'}>BEFORE</font> "
  2578.          ."and <font color=$color{'>'}>AFTER</font> changes to grant-tables</font>\n";
  2579.     print "</th>";
  2580.     print "</tr>\n";
  2581.     print "<tr>\n";    
  2582.     $line1 .= sprintf("<th>%-20s</th>",'Host, User, DB');
  2583.     foreach $header (@headers) {
  2584.       $line1 .= sprintf("<th>%-4s</th>",$header);
  2585.     }
  2586.     print "$line1</tr>\n";
  2587.     }
  2588.  
  2589.     foreach $line (@diffs) {
  2590.         $type = substr($line,0,1);
  2591.         $line = substr($line,1);
  2592.         ($host,$user,$db,@priv) = split(/,/,$line);
  2593.         if ($MySQLaccess::CMD) {
  2594.            if ($type ne $curblock) {
  2595.               $curblock = $type;
  2596.               print $block{$curblock},":\n";
  2597.            }
  2598.            #print "$line\n";
  2599.            write;
  2600.         }
  2601.         if ($MySQLaccess::CGI) {
  2602.            if ($type ne $curblock) {
  2603.               $curblock = $type;
  2604.               print "<tr><td><b>$block{$curblock}<b></td></tr>\n";
  2605.            }
  2606.            $line1="<td><font color=$color{$type}>$host, $user, $db</font></td>";
  2607.            foreach $field (@priv) {
  2608.               $line1 .= sprintf("<td align=center><font color=$color{$type}>%-4s</font></td>",$field);
  2609.            }
  2610.            print "<tr>$line1</tr>\n";
  2611.         }
  2612.     }
  2613.     print      "\n";
  2614.     if ($MySQLaccess::CMD) {
  2615.     print "---------------------------------------------------------------------\n";
  2616.     }
  2617.     if ($MySQLaccess::CGI) {
  2618.     print      "</table><br>";
  2619.     }
  2620.  
  2621.  
  2622.     return 1;
  2623. }
  2624.  
  2625. # ======================================
  2626. # sub Tabular_Report
  2627. #  Tabular report,
  2628. #  suitable for 1 triple (host,db,user)
  2629. # ======================================
  2630. sub Tabular_Report {
  2631.     my ($host,$user,$db,$a) = @_;
  2632.     my $column=2;
  2633.  
  2634.     # -----------------------------
  2635.     # separator
  2636.     if ($MySQLaccess::Report::separator) { print "$MySQLaccess::Report::separator\n"; }
  2637.     
  2638.     # -----------------------------
  2639.     # print table of access-rights
  2640.     my $rows = int(@MySQLaccess::Grant::Privileges/2);  #round up
  2641.     my @table=();
  2642.     $j=0;
  2643.     for $i (0 .. $rows-1) {
  2644.       $table[$j]=$MySQLaccess::Grant::Privileges[$i];
  2645.       $j = $j+2;
  2646.     }
  2647.     $j=1;
  2648.     for $i ($rows .. $#MySQLaccess::Grant::Privileges) {
  2649.       $table[$j]=$MySQLaccess::Grant::Privileges[$i];
  2650.       $j = $j+2;
  2651.     }
  2652.     if ($MySQLaccess::CMD) {
  2653.     print "\n";
  2654.     print "Access-rights\n";
  2655.     print "for USER '$user', from HOST '$host', to DB '$db'\n";
  2656.     }
  2657.     if ($MySQLaccess::CGI) {
  2658.     print "<table border width=100%>\n";
  2659.     print "<tr>\n";
  2660.     }
  2661.     if ($MySQLaccess::CGI) {
  2662.     print "<th colspan=5>";
  2663.     print "<font color=Red>Access-rights</font>\n";
  2664.     print "for USER '<font color=Green>$user</font>', from HOST '<font color=Green>$host</font>', to DB '<font color=Green>$db</font>'\n";
  2665.     print "</th>";
  2666.     print "</tr>\n";
  2667.     print "<tr>\n";
  2668.     }
  2669.     if ($MySQLaccess::CMD) {
  2670.     print      "\t+-----------------+---+\t+-----------------+---+";
  2671.     }
  2672.     foreach $field (@table) {
  2673.         if ($MySQLaccess::CMD) {
  2674.           if ($column==2) { print "\n\t"; $column=1;}
  2675.           else            { print "\t";   $column=2;}
  2676.           printf "| %-15s | %s |",$field,$Answer{$a->{$field}}; 
  2677.         }
  2678.         if ($MySQLaccess::CGI) {
  2679.           if ($column==2) { print "</tr>\n<tr>\n"; $column=1;}
  2680.           else            { print "<td width=10%></td>";   $column=2;}
  2681.           printf " <td width=35%><b>%-15s</b></td><td width=10%>%s</td>\n",$field,$Answer{$a->{$field}}; 
  2682.         }
  2683.     }
  2684.     print      "\n";
  2685.     if ($MySQLaccess::CMD) {
  2686.     print      "\t+-----------------+---+\t+-----------------+---+\n";
  2687.     }
  2688.     if ($MySQLaccess::CGI) {
  2689.     print      "</tr>\n</table><br>";
  2690.     }
  2691.  
  2692.     # ---------------
  2693.     # print notes:
  2694.     foreach $note (@MySQLaccess::Grant::Notes) {
  2695.       my $message = $MESSAGES{$note};
  2696.       $message =~ s/\$user/$user/g; 
  2697.       $message =~ s/\$db/$db/g;
  2698.       $message =~ s/\$host/$host/g;
  2699.       $message =~ s/\$password/$password/g;
  2700.       $PREFIX='NOTE';
  2701.       if ($MySQLaccess::CMD) {
  2702.       my @lines = split(/\n/,$message);
  2703.       foreach $line (@lines) { 
  2704.         print "$PREFIX:\t $line\n"; 
  2705.         $PREFIX='    ';
  2706.       }
  2707.       }
  2708.       if ($MySQLaccess::CGI) {
  2709.       print "<b>$PREFIX:</b> $message<br>\n";
  2710.       }
  2711.     } 
  2712.  
  2713.     # ---------------
  2714.     # print warnings:
  2715.     foreach $warning (@MySQLaccess::Grant::Warnings) {
  2716.       my $message = $MESSAGES{$warning};
  2717.       $message =~ s/\$user/$user/g;
  2718.       $message =~ s/\$db/$db/g;
  2719.       $message =~ s/\$host/$host/g;
  2720.       $message =~ s/\$password/$password/g;
  2721.       $PREFIX='BEWARE';
  2722.       if ($MySQLaccess::CMD) {
  2723.       my @lines = split(/\n/,$message);
  2724.       foreach $line (@lines) { 
  2725.         print "$PREFIX:\t $line\n"; 
  2726.         $PREFIX='      ';
  2727.       }
  2728.       }
  2729.       if ($MySQLaccess::CGI) {
  2730.       print "<b>$PREFIX:</b> $message<br>\n";
  2731.       }
  2732.     }
  2733.  
  2734.     # ---------------
  2735.     # print errors:
  2736.     foreach $error (@MySQLaccess::Grant::Errors) {
  2737.       my $message = $MESSAGES{$error};
  2738.       $message =~ s/\$user/$user/g;
  2739.       $message =~ s/\$db/$db/g;
  2740.       $message =~ s/\$host/$host/g;
  2741.       $message =~ s/\$password/$password/g;
  2742.       $PREFIX='ERROR';
  2743.       if ($MySQLaccess::CMD) {
  2744.       my @lines = split(/\n/,$message);
  2745.       foreach $line (@lines) { 
  2746.         print "$PREFIX:\t $line\n"; 
  2747.         $PREFIX='    ';
  2748.       }
  2749.       }
  2750.       if ($MySQLaccess::CGI) {
  2751.       print "<b>$PREFIX:</b> $message<br>\n";
  2752.       }
  2753.     }
  2754.  
  2755.     # ---------------
  2756.     # inform if there are no rules ==> full access for everyone.
  2757.     if ($MySQLaccess::Grant::full_access) { print "$MESSAGES{'full_access'}\n"; }
  2758.  
  2759.     # ---------------
  2760.     # print the rules used
  2761.     print "\n";
  2762.     if ($MySQLaccess::CMD) {
  2763.     print "The following rules are used:\n";
  2764.     foreach $field (sort(keys(%MySQLaccess::Grant::Rules))) {
  2765.       my $rule = (defined($MESSAGES{$MySQLaccess::Grant::Rules{$field}}) ? $MESSAGES{$MySQLaccess::Grant::Rules{$field}} : $MySQLaccess::Grant::Rules{$field});
  2766.       $rule =~ s/\t/','/g;
  2767.       printf " %-5s : '%s'\n",$field,$rule;
  2768.     }
  2769.     }
  2770.     if ($MySQLaccess::CGI) {
  2771.     print "<br>\n";
  2772.     print "<table border width=100%>\n";
  2773.     print "<tr><th colspan=2>The following rules are used:</th></tr>\n";
  2774.     foreach $field (sort(keys(%MySQLaccess::Grant::Rules))) {
  2775.       my $rule = (defined($MESSAGES{$MySQLaccess::Grant::Rules{$field}}) ? $MESSAGES{$MySQLaccess::Grant::Rules{$field}} : $MySQLaccess::Grant::Rules{$field});
  2776.       $rule =~ s/\t/','/g;
  2777.       printf "<tr><th>%-5s</th><td>'%s'</td></tr>\n",$field,$rule;
  2778.     }
  2779.     print "</table>\n";
  2780.     }
  2781.  
  2782.     return 1;
  2783. }
  2784.  
  2785. # ======================================
  2786. # sub Matrix_Report:
  2787. #  single-line output foreach triple,
  2788. #  no notes,warnings,...
  2789. # ======================================
  2790. sub Matrix_Report {
  2791.     my ($host,$user,$db,$a) = @_;
  2792.     my @headers = ();
  2793.     
  2794.     if (! $headers) {
  2795.        # -----------------------------
  2796.        # create column-headers
  2797.        foreach $field (@MySQLaccess::Grant::Privileges) {
  2798.          push(@headers,substr($field,0,4));
  2799.        }
  2800.     
  2801.        # -----------------------------
  2802.        # print column-headers
  2803.        print "\n";
  2804.        if ($MySQLaccess::CMD) {
  2805.          my $line1="";
  2806.          my $line2="";
  2807.          foreach $header (@headers) {
  2808.            $line1 .= sprintf("%-4s ",$header);
  2809.            $line2 .= sprintf("%s ",'----');
  2810.          }
  2811.          $line1 .= sprintf("| %-20s",'Host,User,DB');
  2812.          $line2 .= sprintf("+ %-20s",'-' x 20);
  2813.          print "$line1\n";
  2814.          print "$line2\n";
  2815.        }
  2816.        if ($MySQLaccess::CGI) {
  2817.          print "<table width=100% border>\n";
  2818.          my $line1="<tr>";
  2819.          foreach $header (@headers) {
  2820.            $line1 .= sprintf("<th>%-4s</th>",$header);
  2821.          }
  2822.          $line1 .= sprintf("<th>%-20s</th>",'Host, User, DB');
  2823.          print "$line1</tr>\n";
  2824.        }
  2825.  
  2826.        # ----------------------------
  2827.        # column-headers should only be 
  2828.        # printed once.
  2829.        $MySQLaccess::Report::headers=1;
  2830.     }
  2831.  
  2832.     # ------------------------
  2833.     # print access-information
  2834.     if ($MySQLaccess::CMD) {
  2835.       foreach $field (@MySQLaccess::Grant::Privileges) {
  2836.         printf " %-2s  ",$Answer{$a->{$field}}; 
  2837.       }
  2838.       printf "| %-20s",join(',',$host,$user,$db);
  2839.       print "\n";
  2840.     }
  2841.     if ($MySQLaccess::CGI) {
  2842.       print "<tr>";
  2843.       foreach $field (@MySQLaccess::Grant::Privileges) {
  2844.         printf "<td align=center>%-2s</td>",$Answer{$a->{$field}}; 
  2845.       }
  2846.       printf "<td><b>%-20s</b></td>",join(', ',$host,$user,$db);
  2847.       print "</tr>\n";
  2848.     }
  2849.  
  2850.     return 1;
  2851. }
  2852.  
  2853.  
  2854. # ======================================
  2855. # sub Raw_Report:
  2856. #  single-line output foreach triple,
  2857. #  no notes,warnings,...
  2858. # ======================================
  2859. sub Raw_Report {
  2860.     my ($host,$user,$db,$a) = @_;
  2861.     my @headers = ();
  2862.     my $string = "";
  2863.     
  2864.     # ------------------------
  2865.     # print access-information
  2866.     $string = "$host,$user,$db,";
  2867.     foreach $field (@MySQLaccess::Grant::Privileges) {
  2868.       $string .= $Answer{$a->{$field}} . ","; 
  2869.     }
  2870.     return $string;
  2871. }
  2872.  
  2873.  
  2874. #######################################################################
  2875. package MySQLaccess::Wildcards;
  2876. BEGIN {
  2877.     $DEBUG     = 0;
  2878.     $DEBUG     = $MySQLaccess::DEBUG unless ($DEBUG);
  2879. }
  2880. # ############################################
  2881. # SQL, WILDCARDS and REGULAR EXPRESSIONS 
  2882. # ============================================
  2883. # translage SQL-expressions to Reg-expressions
  2884. # ============================================
  2885. sub SQL2Reg {
  2886.     my ($expr) = @_;
  2887.     my $expr_o = $expr;
  2888.     $expr  =~ s/\./\\./g;
  2889.     $expr  =~ s/\\%/\002/g;
  2890.     $expr  =~ s/%/.*/g;
  2891.     $expr  =~ s/\002/%/g;
  2892.     $expr  =~ s/\\_/\002/g;
  2893.     $expr  =~ s/_/.+/g;
  2894.     $expr  =~ s/\002/_/g;
  2895.     MySQLaccess::Debug::Print(2,"$expr_o --> $expr");
  2896.     return $expr;
  2897. }
  2898.  
  2899. # translage WILDcards to Reg-expressions
  2900. # ============================================
  2901. sub Wild2Reg {
  2902.     my ($expr) = @_;
  2903.     my $expr_o = $expr;
  2904.     $expr  =~ s/\./\\./g;
  2905.     $expr  =~ s/\\\*/\002/g;
  2906.     $expr  =~ s/\*/.*/g;
  2907.     $expr  =~ s/\002/*/g;
  2908.     $expr  =~ s/\\\?/\002/g;
  2909.     $expr  =~ s/\?/.+/g;
  2910.     $expr  =~ s/\002/?/g;
  2911.     MySQLaccess::Debug::Print(2,"$expr_o --> $expr");
  2912.     return $expr;
  2913. }
  2914.  
  2915. # =============================================
  2916. # match a given string with a template
  2917. # =============================================
  2918. sub MatchTemplate {
  2919.     my ($tpl,$string) = @_;
  2920.     my $match=0;
  2921.     if ($string=~ /^$tpl$/ or $tpl eq '') { $match=1; }
  2922.     else                                  { $match=0;}
  2923.     MySQLaccess::Debug::Print(2,"($tpl,$string) --> $match");
  2924.     return $match;
  2925. }
  2926.  
  2927. #######################################################################
  2928. package MySQLaccess::Host;
  2929. BEGIN {
  2930.     $localhost = undef;
  2931.     $DEBUG     = 2;
  2932.     $DEBUG     = $MySQLaccess::DEBUG unless ($DEBUG);
  2933. }
  2934. # ======================================
  2935. # sub IP2Name
  2936. #  return the Name with the corr. IP-nmbr
  2937. #  (no aliases yet!!)
  2938. # ======================================
  2939. sub IP2Name {
  2940.     my ($ip) = @_;
  2941.     my $ip_o = $ip;
  2942.     if ($ip !~ /([0-9]+)\.([0-9]+)\.([0-9]+)\.([0-9]+)/o) {
  2943.        MySQLaccess::Debug::Print(3,"'$ip' is not an ip-number, returning IP=$ip");
  2944.        return $ip;
  2945.     }
  2946.     MySQLaccess::Debug::Print(4,"IP=$ip split up => $1.$2.$3.$4");
  2947.     $ip = pack "C4",$1,$2,$3,$4;
  2948.     MySQLaccess::Debug::Print(4,"IP packed -> >>$ip<<\n");
  2949.     my ($name,$aliases,$addrtype,$length,@addrs) = gethostbyaddr($ip, AF_INET);
  2950.     MySQLaccess::Debug::Print(3,"IP=$ip_o => hostname=$name");
  2951.     MySQLaccess::Debug::Print(4,"aliases=$aliases");
  2952.     MySQLaccess::Debug::Print(4,"addrtype=$addrtype - length=$length");
  2953.     return ($name || $ip);
  2954.     #return ($name || undef);
  2955. }
  2956.  
  2957. # ======================================
  2958. # sub Name2IP
  2959. #  return the IP-number of the host
  2960. # ======================================
  2961. sub Name2IP {
  2962.     my ($name) = @_;
  2963.     if ($name =~ /[%_]/) { 
  2964.        MySQLaccess::Debug::Print(3,"'$name' contains SQL-wildcards, returning name=$name");
  2965.        return $name; 
  2966.     }
  2967.     my ($_name,$aliases,$addrtype,$length,@addrs) = gethostbyname($name);
  2968.     my ($a,$b,$c,$d) = unpack('C4',$addrs[0]);
  2969.     my $ip = "$a.$b.$c.$d";
  2970.     MySQLaccess::Debug::Print(3,"hostname=$name => IP=$ip");
  2971.     MySQLaccess::Debug::Print(4,"aliases=$aliases");
  2972.     MySQLaccess::Debug::Print(4,"addrtype=$addrtype - length=$length");
  2973.     #if ($ip ne "") { return "$ip"; }
  2974.     #else           { return undef; }
  2975.     return ($ip || $name);
  2976. }
  2977.  
  2978. # ========================================
  2979. # sub LocalHost
  2980. #  some special action has to be taken for
  2981. #  the localhost
  2982. # ========================================
  2983. sub LocalHost {
  2984.     if (!defined($MySQLaccess::Host::localhost)) {
  2985.        $MySQLaccess::Host::localhost = Sys::Hostname::hostname();
  2986.        MySQLaccess::Debug::Print(3,"Setting package variable \$localhost=$MySQLaccess::Host::localhost");
  2987.     }
  2988.     my $host = $localhost;
  2989.     MySQLaccess::Debug::Print(3,"localhost = $host");
  2990.     return $host;
  2991. }
  2992.  
  2993. # ========================================
  2994. # check if the given hostname (or ip)
  2995. # corresponds with the localhost
  2996. # ========================================
  2997. sub Is_localhost {
  2998.     my ($host_tpl) = @_;
  2999.     my $isit = 0;
  3000.     if (($MySQLaccess::host_name eq $localhost) or ($MySQLaccess::host_ip eq $local_ip)) {
  3001.     MySQLaccess::Debug::Print(2,"Checking for localhost");
  3002.       MySQLaccess::Debug::Print(3,"because ($MySQLaccess::host_name EQ $localhost) AND ($MySQLaccess::host_ip EQ $local_ip)");
  3003.       $isit = ( 'localhost' =~ /$host_tpl/ ) ? 1 : 0;
  3004.       MySQLaccess::Debug::Print(3," 'localhost' =?= $host_tpl  -> $isit");
  3005.       return $isit;
  3006.     }
  3007.     else {
  3008.       MySQLaccess::Debug::Print(4,"Not checking for localhost");
  3009.       MySQLaccess::Debug::Print(4,"because ($MySQLaccess::host_name != $localhost) AND ($MySQLaccess::host_ip != $local_ip)");
  3010.       return 0;
  3011.     }
  3012. }
  3013.  
  3014.  
  3015. # =========================================
  3016. # check if host (IP or name) can be matched
  3017. # on the template.
  3018. # =========================================
  3019. sub MatchTemplate {
  3020.     my ($host,$tpl) = @_;
  3021.     my $match = 0;
  3022.    
  3023.     MySQLaccess::Debug::Print(1, "($host) =?= ($tpl)");
  3024.  
  3025.     my $host_name = IP2Name($host);
  3026.     my $host_ip   = Name2IP($host);
  3027.  
  3028.     MySQLaccess::Debug::Print(2, "name=$host_name ; ip=$host_ip");
  3029.     $match = (MySQLaccess::Wildcards::MatchTemplate($tpl,$host_name) or
  3030.              MySQLaccess::Wildcards::MatchTemplate($tpl,$host_ip));
  3031.  
  3032.     MySQLaccess::Debug::Print(2, "($host_name,$host_ip) =?= ($tpl): $ncount");
  3033.  
  3034.     return $match;
  3035. }
  3036.  
  3037. ########################################################################
  3038. package MySQLaccess::Debug;
  3039. BEGIN {
  3040.    my $dbg_file = "$MySQLaccess::script_log";
  3041.    open(DEBUG,"> $dbg_file") or warn "Could not open outputfile $dbg_file for debugging-info\n";
  3042.    select DEBUG;
  3043.    $| = 1;
  3044.    select STDOUT;
  3045. }
  3046. # =========================================
  3047. # Print debugging information on STDERR
  3048. # =========================================
  3049. sub Print {
  3050.     my ($level,$mesg) = @_;
  3051.     my ($pack,$file,$line,$subname,$hasargs,$wantarray) = caller(1);
  3052.     my ($PACK)  = split('::',$subname); 
  3053.     my $DEBUG = ${$PACK."::DEBUG"} ? ${$PACK."::DEBUG"} : $MySQLaccess::DEBUG ;
  3054.     my ($sec,$min,$hour) = localtime();
  3055.     print DEBUG "[$hour:$min:$sec $subname] $mesg\n" if ($DEBUG>=$level);
  3056. }
  3057.  
  3058.